##########
tkcalendar
##########
|Release| |Travis| |Appveyor| |Codecov| |Windows| |Linux| |Mac| |License| |Doc|
tkcalendar is a python module that provides the Calendar and DateEntry widgets for Tkinter.
The DateEntry widget is similar to a Combobox, but the drop-down is not a list but a Calendar to select a date.
Events can be displayed in the Calendar with custom colors and a tooltip displays the event list for a given day.
tkcalendar is compatible with both Python 2 and Python 3.
It supports many locale settings (e.g. 'fr_FR', 'en_US', ..) and the colors are customizable.
The documentation is also available here: https://tkcalendar.readthedocs.io
.. contents:: Table of Contents
Requirements
============
- Linux, Windows, OSX
- Python 3
And the python packages:
- tkinter (included in the python distribution for Windows)
- `babel <https://pypi.org/project/babel/>`_
Installation
============
- Ubuntu: use the PPA `ppa:j-4321-i/ppa <https://launchpad.net/~j-4321-i/+archive/ubuntu/ppa>`__
::
$ sudo add-apt-repository ppa:j-4321-i/ppa
$ sudo apt-get update
$ sudo apt-get install python3-tkcalendar
- Archlinux:
The package is available on `AUR <https://aur.archlinux.org/packages/python-tkcalendar>`__
- With pip:
::
$ pip install tkcalendar
Documentation
=============
Calendar widget
---------------
Syntax
~~~~~~
::
Calendar(master=None, **kw)
Widget keyword options
~~~~~~~~~~~~~~~~~~~~~~
* Standard options
cursor : str
cursor to display when the pointer is in the widget
font : str such as "Arial 20 bold" or a Tkinter Font instance
font of the calendar
borderwidth : int
width of the border around the calendar
state : str
"normal" or "disabled" (unresponsive widget)
* Widget-specific options:
year : int
intinitially displayed year, default is current year.
month : int
initially displayed month, default is current month.
day : int
initially selected day, if month or year is given but not day, no initial selection, otherwise, default is today.
firstweekday : "monday" or "sunday"
first day of the week
weekenddays : list
days to be displayed as week-end days given as a list of integers corresponding to the number of the day in the week (e.g. [6, 7] for the last two days of the week).
mindate : datetime.date or datetime.datetime (default is None)
minimum allowed date
maxdate : datetime.date or datetime.datetime (default is None)
maximum allowed date
showweeknumbers : bool (default is True)
whether to display week numbers.
showothermonthdays : bool (default is True)
whether to display the last days of the previous month and the first of the next month.
locale : str
locale to use, e.g. 'en_US'
date_pattern : str
date pattern used to format the date as a string. The default pattern used
is ``babel``'s short date format in the calendar's locale.
A valid pattern is a combination of 'd', 'm' and 'y' separated by
non letter characters to indicate how and in which order the
year, month and day should be displayed.
= =========================================================================
d 'd' for the day of month number without padding, 'dd' for a two-digit day
m 'm' for the month number without padding, 'mm' for a two-digit month
y 'yy' for the two last digits of the year, any other number of 'y's for
the full year with an extra padding of zero if it has less digits than
the number of 'y's.
= =========================================================================
Examples for ``datetime.date(2019, 7, 1)``
- 'y-mm-dd' → '2019-07-01'
- 'm/d/yy' → '7/1/19'
selectmode : "none" or "day" (default)
whether the user can change the selected day with a mouse click.
textvariable : StringVar
connect the currently selected date to the variable.
* Style options:
background :
background color of calendar border and month/year name
foreground :
foreground color of month/year name
disabledbackground : str
background color of calendar border and month/year name in disabled state
disabledforeground : str
foreground color of month/year name in disabled state
bordercolor :
day border color
headersbackground :
background color of day names and week numbers
headersforeground :
foreground color of day names and week numbers
selectbackground :
background color of selected day
selectforeground :
foreground color of selected day
disabledselectbackground :
background color of selected day in disabled state
disabledselectforeground :
foreground color of selected day in disabled state
normalbackground :
background color of normal week days
normalforeground :
foreground color of normal week days
weekendbackground :
background color of week-end days
weekendforeground :
foreground color of week-end days
othermonthforeground :
foreground color of normal week days belonging to the previous/next month
othermonthbackground :
background color of normal week days belonging to the previous/next month
othermonthweforeground :
foreground color of week-end days belonging to the previous/next month
othermonthwebackground :
background color of week-end days belonging to the previous/next month
disableddaybackground :
background color of days in disabled state
disableddayforeground :
foreground color of days in disabled state
* Tooltip options (for calevents):
tooltipforeground :
tooltip text color
tooltipbackground :
tooltip background color
tooltipalpha : float
tooltip opacity between 0 and 1
tooltipdelay : int
delay in ms before displaying the tooltip
Virtual Events
~~~~~~~~~~~~~~
* A ``<<CalendarSelected>>`` event is generated each time the user selects a day with the mouse.
* A ``<<CalendarMonthChanged>>`` event is generated each time the user changes the displayed month.
Widget methods
~~~~~~~~~~~~~~
* Standard methods:
- methods common to all tkinter widgets
(more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/universal.html>`__)
- methods common to all ttk widgets
(more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/ttk-Widget.html>`__)
* Widget-Specific methods:
calevent_cget(ev_id, option) :
Return value of given option for the event *ev_id*.
calevent_configure(ev_id, \*\*kw) :
Return value of given option for the event *ev_id*.
calevent_create(date, text, tags=[]) :
Add new event in calendar and return event id.
Options:
*date*: ``datetime.date`` or ``datetime.datetime`` instance.
*text*: text to put in the tooltip associated to date.
*tags*: list of tags to apply to the event. The last tag determines the way the event is displayed.
If there are several events on the same day, the lowest one (on the tooltip list)
which has tags determines the colors of the day.
calevent_lower(ev_id, below=None) :
Lower event *ev_id* in tooltip event list.
*below*: put event below given one, if below is None, put it at the bottom of tooltip event list.
The day's colors are determined by the last tag of the lowest event which has tags.
calevent_raise(ev_id, above=None) :
Raise event *ev_id* in tooltip event list.
*above*: put *ev_id* above given one, if above is None, put it on top of tooltip event list.
The day's colors are determined by the last tag of the lowest event which has tags.
calevent_remove(\*ev_ids, \*\*kw) :
Remove events from calendar.
Arguments: event ids to remove or 'all' to remove them all.
Keyword arguments: *tag*, *date*. They are taken into account only if no id is given.
Remove all events with given tag on given date. If only date is given,
remove all events on date and if only tag is given, remove all events with tag.
get_date() :
If selectmode is 'day', return the string corresponding to the selected date in the
``Calendar`` locale, otherwise return ``""``.
get_calevents(date=None, tag=None) :
Return event ids of events with given tag and on given date.
If only *date* is given, return event ids of all events on date.
If only *tag* is given, return event ids of all events with tag.
If both options are None, return all event ids.
get_displayed_month() :
Return the currently displayed month in the form of a (month, year) tuple.
see(date) :
Display the month in which *date* is.
*date*: ``datetime.date`` or ``datetime.datetime`` instance.
selection_clear() :
Clear the selection.
selection_get() :
If selectmode is 'day', return the selected date as a ``datetime.date``
instance, otherwise return ``None``.
selection_set(self, date) :
If selectmode is 'day', set the selection to *date* where *date* can be either a ``datetime.date``
instance or a string corresponding to the date format ``"%x"`` in the ``Calendar``
locale. Does nothing if selectmode is ``"none"``.
tag_cget(tag, option) :
Return the value of the tag's option.
tag_config(self, tag, \*\*kw) :
Configure *tag*.
Keyword options: *foreground*, *background* (of the day in the calendar)
tag_delete(tag) :
Delete given tag and remove it from all events.
tag_names() :
Return tuple of existing tags.
DateEntry widget
----------------
Date selection entry with drop-down calendar.
Syntax
~~~~~~
::
DateEntry(master=None, **kw)
Widget keyword options
~~~~~~~~~~~~~~~~~~~~~~
* Keyword options of ``Calendar`` to configure the drop-down calendar
The Calendar option *cursor* has been renamed *calendar_cursor* to
avoid name clashes with the corresponding ``ttk.Entry`` option.
* Keyword options of ``ttk.Entry``
By default, 'validate' is set to 'focusout' and 'validatecommand' is configured so that each
time the widget looses focus, if the content is not a valid date (in locale format '%x'),
it is reset to the previous valid date.
The widget style is set to 'DateEntry'. A custom style inheritting from 'DateEntry'
can be created by naming it '<style name>.DateEntry'
* Virtual Events
A ``<<DateEntrySelected>>`` event is generated each time the user selects a date.
Widget methods
~~~~~~~~~~~~~~
* Standard methods:
- methods common to all tkinter widgets
(more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/universal.html>`__)
- methods common to all ttk widgets
(more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/ttk-Widget.html>`__)
- methods of the ``Entry`` widget
(more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/entry.html>`__)
* Widget-Specific methods:
drop_down() :
Display or withdraw the drop-down calendar depending on its current state.
get_date() :
Return the selected date as a ``datetime.date`` instance.
set_date(self, date) :
Set the value of the DateEntry to *date* where *date* can be either a ``datetime.date``
instance or a string corresponding to the date format `"%x"` in the `Calendar` locale.
HowTos
======
Widget styling, Pyinstaller, Custom date formatting: see https://tkcalendar.readthedocs.io/en/stable/howtos.html
Changelog
=========
- tkcalendar 1.6.1
* Fix typo in ``DateEntry`` that lead to position issues for the drop-down (`#66 <https://github.com/j4321/tkcalendar/issues/66>`_)
- tkcalendar 1.6.0
* Fix vanishing of the drop-down calendar on any click when grab_set is used
* Fix ``DateEntry`` cursor customization which had no effect
* Temporarily fix `python issue 38661 <https://bugs.python.org/issue38661>`_ (`#61 <https://github.com/j4321/tkcalendar/issues/61>`_)
* Add *calendar_cursor* option to change the cursor on the ``Calendar`` of the ``DateEntry`` (`#55 <https://github.com/j4321/tkcalendar/issues/55>`_)
* Fix always on top bug using resizable (`#62 <https://github.com/j4321/tkcalendar/issues/62>`_)
- tkcalendar 1.5.1
* Fix calendar drop-down not in front issue if window has the ``-topmost`` attribute in Windows (`#49 <https://github.com/j4321/tkcalendar/issues/49>`_)
* Make ``Calendar.config()`` and ``DateEntry.config()`` accept a dictionary like standard tkinter widgets
* Fix calendar not hiding when clicking again on ``DateEntry`` drop-down button in Windows (`#51 <https://github.com/j4321/tkcalendar/issues/51>`_)
* Fix *maxdate* disabled while it sould be the latest allowed date (`#50 <https://github.com/j4321/tkcalendar/issues/50>`_)
- tkcalendar 1.5.0
* Add *disabledforeground* and *disabledbackground* options to further customize
the disabled state appearance of the ``Calendar``
* Add *maxdate* and *mindate* options to set an allowed date range for date selection
* Add *weekenddays* option to choose the days colored as week-end days (`#37 <https://github.com/j4321/tkcalendar/issues/37>`_)
* Add *date_pattern* option to customize the date format
* Add ``Calendar.see()`` method to make sure a date is visible
* Make ``Calendar.selection_clear()`` actually clear the selection
* Make *locale* option editable after the creation of the Calendar
* Fix ``ValueError`` when retrieving default locale
* Fix date parsing error in Swedish locale and some others (`#44 <https://github.com/j4321/tkcalendar/issues/44>`_)
* Improve compliance with ttk themes by making the ``DateEntry`` look like a ``ttk.Combobox`` (`#42 <https://github.com/j4321/tkcalendar/issues/42>`_)
* Fix high CPU issues in Windows (`#36 <https://github.com/j4321/tkcalendar/issues/36>`_)
- tkcalendar 1.4.0
* Add ``<<CalendarMonthChanged>>`` virtual event to the ``Calendar`` widget
* Add ``get_displayed_month()`` method to the ``Calendar`` widget
* Add *showothermonthdays* option to show/hide the last and first days of the previous and next months
* Fix display of events for January days showing on December page and conversely
- tkcalendar 1.3.1
* Fix bug in day selection when firstweekday is 'sunday' (`#28 <https://github.com/j4321/tkcalendar/issues/28>`_)
- tkcalendar 1.3.0
* No longer set locale globally to avoid conflicts between several instances, use ``babel`` module instead (`#15 <https://github.com/j4321/tkcalendar/issues/15>`_)
* Add *showwekknumbers* option to show/hide week numbers (`#18 <https://github.com/j4321/tkcalendar/issues/18>`_)
* Add *firstweekday* option to choose first week day between 'monday' and 'sunday' (`#25 <https://github.com/j4321/tkcalendar/issues/25>`_)
* Make ``DateEntry`` compatible with more ttk themes, especially OSX default theme (`#16 <https://github.com/j4321/tkcalendar/issues/16>`_)
* Add possibility to display special events (like birthdays, ..) in the calendar
The events are displayed with colors defined by tags and the event description is displayed in a tooltip
(see documentation) (`#19 <https://github.com/j4321/tkcalendar/issues/19>`_)
- tkcalendar 1.2.1
* Fix ``ValueError`` in ``DateEntry`` with Python 3.6.5 (`#13 <https://github.com/j4321/tkcalendar/issues/13>`_)
- tkcalendar 1.2.0
* Add *textvariable* option to ``Calendar`` (`#6 <https://github.com/j4321/tkcalendar/issues/6>`_)
* Add *state* ('normal' or 'disabled') option to Calendar
* Add *disabledselectbackground*, *disabledselectforeground*,
*disableddaybackground* and *disableddayforeground* options to configure colors
when ``Calendar`` is disabled
* Fix ``DateEntry`` behavior in readonly mode
* Make ``Calendar.selection_get()`` always return a ``datetime.date``
- tkcalendar 1.1.5
* Fix endless triggering of ``<<ThemeChanged>>`` event in ``DateEntry`` (`#9 <https://github.com/j4321/tkcalendar/issues/9>`_)
- tkcalendar 1.1.4
* Fix error in January due to week 53
* Fix ``DateEntry`` for ttk themes other than 'clam' (`#3 <https://github.com/j4321/tkcalendar/issues/3>`_)
- tkcalendar 1.1.3
* Make ``DateEntry`` support initialisation with partial dates (e.g. just year=2010)
* Improve handling of wrong year-month-day combinations
- tkcalendar 1.1.2
* Fix bug after destroying a ``DateEntry``
* Fix bug in style and font
- tkcalendar 1.1.1
* Fix bug when content of ``DateEntry`` is not a valid date
- tkcalendar 1.1.0
* Fix display of the first days of the next month
* Increment year when going from December to January
* Add widget ``DateEntry``: date selection entry with drop-down calendar
* Add *borderwidth*, *othermonthbackground*, *othermonthweforeground*,
*othermonthwebackground* options to further customize the
appearance of the calendar
- tkcalendar 1.0.0
* Initial version
Example
=======
.. code:: python
from tkcalendar import Calendar, DateEntry
try:
import tkinter as tk
from tkinter import ttk
except ImportError:
import Tkinter as tk
import ttk
def example1():
def print_sel():
print(cal.selection_get())
cal.see(datetime.date(year=2016, month=2, day=5))
top = tk.Toplevel(root)
import datetime
today = datetime.date.today()
mindate = datetime.date(year=2018, month=1, day=21)
maxdate = today + datetime.timedelta(days=5)
print(mindate, maxdate)
cal = Calendar(top, font="Arial 14", selectmode='day', locale='en_US',
mindate=mindate, maxdate=maxdate, disabledforeground='red',
cursor="hand1", year=2018, month=2, day=5)
cal.pack(fill="both", expand=True)
ttk.Button(top, text="ok", command=print_sel).pack()
def example2():
top = tk.Toplevel(root)
cal = Calendar(top, selectmode='none')
date = cal.datetime.today() + cal.timedelta(days=2)
cal.calevent_create(date, 'Hello World', 'message')
cal.calevent_create(date, 'Reminder 2', 'reminder')
cal.calevent_create(date + cal.timedelta(days=-2), 'Reminder 1', 'reminder')
cal.calevent_create(date + cal.timedelta(days=3), 'Message', 'message')
cal.tag_config('reminder', background='red', foreground='yellow')
cal.pack(fill="both", expand=True)
ttk.Label(top, text="Hover over the events.").pack()
def example3():
top = tk.Toplevel(root)
ttk.Label(top, text='Choose date').pack(padx=10, pady=10)
cal = DateEntry(top, width=12, background='darkblue',
foreground='white', borderwidth=2, year=2010)
cal.pack(padx=10, pady=10)
root = tk.Tk()
ttk.Button(root, text='Calendar', command=example1).pack(padx=10, pady=10)
ttk.Button(root, text='Calendar with events', command=example2).pack(padx=10, pady=10)
ttk.Button(root, text='DateEntry', command=example3).pack(padx=10, pady=10)
root.mainloop()
.. |Release| image:: https://badge.fury.io/py/tkcalendar.svg
:alt: Latest Release
:target: https://pypi.org/project/tkcalendar/
.. |Linux| image:: https://img.shields.io/badge/platform-Linux-blue.svg
:alt: Platform
.. |Windows| image:: https://img.shields.io/badge/platform-Windows-blue.svg
:alt: Platform
.. |Mac| image:: https://img.shields.io/badge/platform-Mac-blue.svg
:alt: Platform
.. |Travis| image:: https://travis-ci.org/j4321/tkcalendar.svg?branch=master
:target: https://travis-ci.org/j4321/tkcalendar
:alt: Travis CI Build Status
.. |Appveyor| image:: https://ci.appveyor.com/api/projects/status/9a5bi9ewvccdmo3a/branch/master?svg=true
:target: https://ci.appveyor.com/project/j4321/tkcalendar/branch/master
:alt: Appveyor Build Status
.. |Codecov| image:: https://codecov.io/gh/j4321/tkcalendar/branch/master/graph/badge.svg
:target: https://codecov.io/gh/j4321/tkcalendar
:alt: Code coverage
.. |License| image:: https://img.shields.io/github/license/j4321/tkcalendar.svg
:target: https://www.gnu.org/licenses/gpl-3.0.en.html
:alt: License
.. |Doc| image:: https://readthedocs.org/projects/tkcalendar/badge/?version=latest
:target: https://tkcalendar.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
Raw data
{
"_id": null,
"home_page": "https://github.com/j4321/tkcalendar",
"name": "tkcalendar",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "tkinter,calendar,date",
"author": "Juliette Monsel",
"author_email": "j_4321@protonmail.com",
"download_url": "https://files.pythonhosted.org/packages/65/3d/3406cf7963661ed890082bff17ed4c5e26b5a564306639303d4fbb2a047f/tkcalendar-1.6.1.tar.gz",
"platform": "",
"description": "##########\ntkcalendar\n##########\n\n|Release| |Travis| |Appveyor| |Codecov| |Windows| |Linux| |Mac| |License| |Doc|\n\ntkcalendar is a python module that provides the Calendar and DateEntry widgets for Tkinter.\nThe DateEntry widget is similar to a Combobox, but the drop-down is not a list but a Calendar to select a date.\nEvents can be displayed in the Calendar with custom colors and a tooltip displays the event list for a given day.\ntkcalendar is compatible with both Python 2 and Python 3.\nIt supports many locale settings (e.g. 'fr_FR', 'en_US', ..) and the colors are customizable.\n\nThe documentation is also available here: https://tkcalendar.readthedocs.io\n\n.. contents:: Table of Contents\n\nRequirements\n============\n\n- Linux, Windows, OSX\n- Python 3\n\nAnd the python packages:\n\n- tkinter (included in the python distribution for Windows)\n- `babel <https://pypi.org/project/babel/>`_\n\n\nInstallation\n============\n\n- Ubuntu: use the PPA `ppa:j-4321-i/ppa <https://launchpad.net/~j-4321-i/+archive/ubuntu/ppa>`__\n\n ::\n\n $ sudo add-apt-repository ppa:j-4321-i/ppa\n $ sudo apt-get update\n $ sudo apt-get install python3-tkcalendar\n\n- Archlinux:\n\n The package is available on `AUR <https://aur.archlinux.org/packages/python-tkcalendar>`__\n\n- With pip:\n\n ::\n\n $ pip install tkcalendar\n\n\nDocumentation\n=============\n\nCalendar widget\n---------------\n\nSyntax\n~~~~~~\n\n ::\n\n Calendar(master=None, **kw)\n\nWidget keyword options\n~~~~~~~~~~~~~~~~~~~~~~\n\n* Standard options\n\n cursor : str\n cursor to display when the pointer is in the widget\n\n font : str such as \"Arial 20 bold\" or a Tkinter Font instance\n font of the calendar\n\n borderwidth : int\n width of the border around the calendar\n\n state : str\n \"normal\" or \"disabled\" (unresponsive widget)\n\n* Widget-specific options:\n\n year : int\n intinitially displayed year, default is current year.\n\n month : int\n initially displayed month, default is current month.\n\n day : int\n initially selected day, if month or year is given but not day, no initial selection, otherwise, default is today.\n\n firstweekday : \"monday\" or \"sunday\"\n first day of the week\n\n weekenddays : list\n days to be displayed as week-end days given as a list of integers corresponding to the number of the day in the week (e.g. [6, 7] for the last two days of the week).\n\n mindate : datetime.date or datetime.datetime (default is None)\n minimum allowed date\n\n maxdate : datetime.date or datetime.datetime (default is None)\n maximum allowed date\n\n showweeknumbers : bool (default is True)\n whether to display week numbers.\n\n showothermonthdays : bool (default is True)\n whether to display the last days of the previous month and the first of the next month.\n\n locale : str\n locale to use, e.g. 'en_US'\n\n date_pattern : str\n date pattern used to format the date as a string. The default pattern used\n is ``babel``'s short date format in the calendar's locale.\n\n A valid pattern is a combination of 'd', 'm' and 'y' separated by\n non letter characters to indicate how and in which order the\n year, month and day should be displayed.\n\n = =========================================================================\n d 'd' for the day of month number without padding, 'dd' for a two-digit day\n\n m 'm' for the month number without padding, 'mm' for a two-digit month\n\n y 'yy' for the two last digits of the year, any other number of 'y's for\n the full year with an extra padding of zero if it has less digits than\n the number of 'y's.\n = =========================================================================\n\n Examples for ``datetime.date(2019, 7, 1)``\n\n - 'y-mm-dd' \u2192 '2019-07-01'\n - 'm/d/yy' \u2192 '7/1/19'\n\n selectmode : \"none\" or \"day\" (default)\n whether the user can change the selected day with a mouse click.\n\n textvariable : StringVar\n connect the currently selected date to the variable.\n\n* Style options:\n\n background :\n background color of calendar border and month/year name\n\n foreground :\n foreground color of month/year name\n\n disabledbackground : str\n background color of calendar border and month/year name in disabled state\n\n disabledforeground : str\n foreground color of month/year name in disabled state\n\n bordercolor :\n day border color\n\n headersbackground :\n background color of day names and week numbers\n\n headersforeground :\n foreground color of day names and week numbers\n\n selectbackground :\n background color of selected day\n\n selectforeground :\n foreground color of selected day\n\n disabledselectbackground :\n background color of selected day in disabled state\n\n disabledselectforeground :\n foreground color of selected day in disabled state\n\n normalbackground :\n background color of normal week days\n\n normalforeground :\n foreground color of normal week days\n\n weekendbackground :\n background color of week-end days\n\n weekendforeground :\n foreground color of week-end days\n\n othermonthforeground :\n foreground color of normal week days belonging to the previous/next month\n\n othermonthbackground :\n background color of normal week days belonging to the previous/next month\n\n othermonthweforeground :\n foreground color of week-end days belonging to the previous/next month\n\n othermonthwebackground :\n background color of week-end days belonging to the previous/next month\n\n disableddaybackground :\n background color of days in disabled state\n\n disableddayforeground :\n foreground color of days in disabled state\n\n* Tooltip options (for calevents):\n\n tooltipforeground :\n tooltip text color\n\n tooltipbackground :\n tooltip background color\n\n tooltipalpha : float\n tooltip opacity between 0 and 1\n\n tooltipdelay : int\n delay in ms before displaying the tooltip\n\nVirtual Events\n~~~~~~~~~~~~~~\n\n * A ``<<CalendarSelected>>`` event is generated each time the user selects a day with the mouse.\n\n * A ``<<CalendarMonthChanged>>`` event is generated each time the user changes the displayed month.\n\nWidget methods\n~~~~~~~~~~~~~~\n\n * Standard methods:\n\n - methods common to all tkinter widgets\n (more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/universal.html>`__)\n\n - methods common to all ttk widgets\n (more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/ttk-Widget.html>`__)\n\n * Widget-Specific methods:\n\n calevent_cget(ev_id, option) :\n Return value of given option for the event *ev_id*.\n\n calevent_configure(ev_id, \\*\\*kw) :\n Return value of given option for the event *ev_id*.\n\n calevent_create(date, text, tags=[]) :\n Add new event in calendar and return event id.\n\n Options:\n\n *date*: ``datetime.date`` or ``datetime.datetime`` instance.\n\n *text*: text to put in the tooltip associated to date.\n\n *tags*: list of tags to apply to the event. The last tag determines the way the event is displayed.\n If there are several events on the same day, the lowest one (on the tooltip list)\n which has tags determines the colors of the day.\n\n calevent_lower(ev_id, below=None) :\n Lower event *ev_id* in tooltip event list.\n\n *below*: put event below given one, if below is None, put it at the bottom of tooltip event list.\n\n The day's colors are determined by the last tag of the lowest event which has tags.\n\n calevent_raise(ev_id, above=None) :\n Raise event *ev_id* in tooltip event list.\n\n *above*: put *ev_id* above given one, if above is None, put it on top of tooltip event list.\n\n The day's colors are determined by the last tag of the lowest event which has tags.\n\n calevent_remove(\\*ev_ids, \\*\\*kw) :\n Remove events from calendar.\n\n Arguments: event ids to remove or 'all' to remove them all.\n\n Keyword arguments: *tag*, *date*. They are taken into account only if no id is given.\n Remove all events with given tag on given date. If only date is given,\n remove all events on date and if only tag is given, remove all events with tag.\n\n get_date() :\n If selectmode is 'day', return the string corresponding to the selected date in the\n ``Calendar`` locale, otherwise return ``\"\"``.\n\n get_calevents(date=None, tag=None) :\n Return event ids of events with given tag and on given date.\n\n If only *date* is given, return event ids of all events on date.\n\n If only *tag* is given, return event ids of all events with tag.\n\n If both options are None, return all event ids.\n\n get_displayed_month() :\n Return the currently displayed month in the form of a (month, year) tuple.\n\n see(date) :\n Display the month in which *date* is.\n\n *date*: ``datetime.date`` or ``datetime.datetime`` instance.\n\n selection_clear() :\n Clear the selection.\n\n selection_get() :\n If selectmode is 'day', return the selected date as a ``datetime.date``\n instance, otherwise return ``None``.\n\n selection_set(self, date) :\n If selectmode is 'day', set the selection to *date* where *date* can be either a ``datetime.date``\n instance or a string corresponding to the date format ``\"%x\"`` in the ``Calendar``\n locale. Does nothing if selectmode is ``\"none\"``.\n\n tag_cget(tag, option) :\n Return the value of the tag's option.\n\n tag_config(self, tag, \\*\\*kw) :\n Configure *tag*.\n\n Keyword options: *foreground*, *background* (of the day in the calendar)\n\n tag_delete(tag) :\n Delete given tag and remove it from all events.\n\n tag_names() :\n Return tuple of existing tags.\n\n\n\nDateEntry widget\n----------------\n\nDate selection entry with drop-down calendar.\n\n\nSyntax\n~~~~~~\n\n ::\n\n DateEntry(master=None, **kw)\n\nWidget keyword options\n~~~~~~~~~~~~~~~~~~~~~~\n\n * Keyword options of ``Calendar`` to configure the drop-down calendar\n\n The Calendar option *cursor* has been renamed *calendar_cursor* to \n avoid name clashes with the corresponding ``ttk.Entry`` option.\n\n * Keyword options of ``ttk.Entry``\n\n By default, 'validate' is set to 'focusout' and 'validatecommand' is configured so that each\n time the widget looses focus, if the content is not a valid date (in locale format '%x'),\n it is reset to the previous valid date.\n\n The widget style is set to 'DateEntry'. A custom style inheritting from 'DateEntry'\n can be created by naming it '<style name>.DateEntry'\n\n * Virtual Events\n\n A ``<<DateEntrySelected>>`` event is generated each time the user selects a date.\n\nWidget methods\n~~~~~~~~~~~~~~\n\n * Standard methods:\n\n - methods common to all tkinter widgets\n (more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/universal.html>`__)\n\n - methods common to all ttk widgets\n (more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/ttk-Widget.html>`__)\n\n - methods of the ``Entry`` widget\n (more details `here <http://infohost.nmt.edu/tcc/help/pubs/tkinter/web/entry.html>`__)\n\n * Widget-Specific methods:\n\n drop_down() :\n Display or withdraw the drop-down calendar depending on its current state.\n\n get_date() :\n Return the selected date as a ``datetime.date`` instance.\n\n set_date(self, date) :\n Set the value of the DateEntry to *date* where *date* can be either a ``datetime.date``\n instance or a string corresponding to the date format `\"%x\"` in the `Calendar` locale.\n\nHowTos\n======\n\nWidget styling, Pyinstaller, Custom date formatting: see https://tkcalendar.readthedocs.io/en/stable/howtos.html\n\nChangelog\n=========\n\n- tkcalendar 1.6.1\n\n * Fix typo in ``DateEntry`` that lead to position issues for the drop-down (`#66 <https://github.com/j4321/tkcalendar/issues/66>`_)\n\n- tkcalendar 1.6.0\n\n * Fix vanishing of the drop-down calendar on any click when grab_set is used \n * Fix ``DateEntry`` cursor customization which had no effect\n * Temporarily fix `python issue 38661 <https://bugs.python.org/issue38661>`_ (`#61 <https://github.com/j4321/tkcalendar/issues/61>`_)\n * Add *calendar_cursor* option to change the cursor on the ``Calendar`` of the ``DateEntry`` (`#55 <https://github.com/j4321/tkcalendar/issues/55>`_)\n * Fix always on top bug using resizable (`#62 <https://github.com/j4321/tkcalendar/issues/62>`_)\n\n- tkcalendar 1.5.1\n\n * Fix calendar drop-down not in front issue if window has the ``-topmost`` attribute in Windows (`#49 <https://github.com/j4321/tkcalendar/issues/49>`_)\n * Make ``Calendar.config()`` and ``DateEntry.config()`` accept a dictionary like standard tkinter widgets\n * Fix calendar not hiding when clicking again on ``DateEntry`` drop-down button in Windows (`#51 <https://github.com/j4321/tkcalendar/issues/51>`_)\n * Fix *maxdate* disabled while it sould be the latest allowed date (`#50 <https://github.com/j4321/tkcalendar/issues/50>`_)\n\n- tkcalendar 1.5.0\n\n * Add *disabledforeground* and *disabledbackground* options to further customize\n the disabled state appearance of the ``Calendar``\n * Add *maxdate* and *mindate* options to set an allowed date range for date selection\n * Add *weekenddays* option to choose the days colored as week-end days (`#37 <https://github.com/j4321/tkcalendar/issues/37>`_)\n * Add *date_pattern* option to customize the date format\n * Add ``Calendar.see()`` method to make sure a date is visible\n * Make ``Calendar.selection_clear()`` actually clear the selection\n * Make *locale* option editable after the creation of the Calendar\n * Fix ``ValueError`` when retrieving default locale\n * Fix date parsing error in Swedish locale and some others (`#44 <https://github.com/j4321/tkcalendar/issues/44>`_)\n * Improve compliance with ttk themes by making the ``DateEntry`` look like a ``ttk.Combobox`` (`#42 <https://github.com/j4321/tkcalendar/issues/42>`_)\n * Fix high CPU issues in Windows (`#36 <https://github.com/j4321/tkcalendar/issues/36>`_)\n\n- tkcalendar 1.4.0\n\n * Add ``<<CalendarMonthChanged>>`` virtual event to the ``Calendar`` widget\n * Add ``get_displayed_month()`` method to the ``Calendar`` widget\n * Add *showothermonthdays* option to show/hide the last and first days of the previous and next months\n * Fix display of events for January days showing on December page and conversely\n\n- tkcalendar 1.3.1\n\n * Fix bug in day selection when firstweekday is 'sunday' (`#28 <https://github.com/j4321/tkcalendar/issues/28>`_)\n\n- tkcalendar 1.3.0\n\n * No longer set locale globally to avoid conflicts between several instances, use ``babel`` module instead (`#15 <https://github.com/j4321/tkcalendar/issues/15>`_)\n * Add *showwekknumbers* option to show/hide week numbers (`#18 <https://github.com/j4321/tkcalendar/issues/18>`_)\n * Add *firstweekday* option to choose first week day between 'monday' and 'sunday' (`#25 <https://github.com/j4321/tkcalendar/issues/25>`_)\n * Make ``DateEntry`` compatible with more ttk themes, especially OSX default theme (`#16 <https://github.com/j4321/tkcalendar/issues/16>`_)\n * Add possibility to display special events (like birthdays, ..) in the calendar\n The events are displayed with colors defined by tags and the event description is displayed in a tooltip\n (see documentation) (`#19 <https://github.com/j4321/tkcalendar/issues/19>`_)\n\n- tkcalendar 1.2.1\n\n * Fix ``ValueError`` in ``DateEntry`` with Python 3.6.5 (`#13 <https://github.com/j4321/tkcalendar/issues/13>`_)\n\n- tkcalendar 1.2.0\n\n * Add *textvariable* option to ``Calendar`` (`#6 <https://github.com/j4321/tkcalendar/issues/6>`_)\n * Add *state* ('normal' or 'disabled') option to Calendar\n * Add *disabledselectbackground*, *disabledselectforeground*,\n *disableddaybackground* and *disableddayforeground* options to configure colors\n when ``Calendar`` is disabled\n * Fix ``DateEntry`` behavior in readonly mode\n * Make ``Calendar.selection_get()`` always return a ``datetime.date``\n\n- tkcalendar 1.1.5\n\n * Fix endless triggering of ``<<ThemeChanged>>`` event in ``DateEntry`` (`#9 <https://github.com/j4321/tkcalendar/issues/9>`_)\n\n- tkcalendar 1.1.4\n\n * Fix error in January due to week 53\n * Fix ``DateEntry`` for ttk themes other than 'clam' (`#3 <https://github.com/j4321/tkcalendar/issues/3>`_)\n\n- tkcalendar 1.1.3\n\n * Make ``DateEntry`` support initialisation with partial dates (e.g. just year=2010)\n * Improve handling of wrong year-month-day combinations\n\n- tkcalendar 1.1.2\n\n * Fix bug after destroying a ``DateEntry``\n * Fix bug in style and font\n\n- tkcalendar 1.1.1\n\n * Fix bug when content of ``DateEntry`` is not a valid date\n\n- tkcalendar 1.1.0\n\n * Fix display of the first days of the next month\n * Increment year when going from December to January\n * Add widget ``DateEntry``: date selection entry with drop-down calendar\n * Add *borderwidth*, *othermonthbackground*, *othermonthweforeground*,\n *othermonthwebackground* options to further customize the\n appearance of the calendar\n\n- tkcalendar 1.0.0\n\n * Initial version\n\n\nExample\n=======\n\n.. code:: python\n\n from tkcalendar import Calendar, DateEntry\n try:\n import tkinter as tk\n from tkinter import ttk\n except ImportError:\n import Tkinter as tk\n import ttk\n\n\n def example1():\n def print_sel():\n print(cal.selection_get())\n cal.see(datetime.date(year=2016, month=2, day=5))\n\n top = tk.Toplevel(root)\n\n import datetime\n today = datetime.date.today()\n\n mindate = datetime.date(year=2018, month=1, day=21)\n maxdate = today + datetime.timedelta(days=5)\n print(mindate, maxdate)\n\n cal = Calendar(top, font=\"Arial 14\", selectmode='day', locale='en_US',\n mindate=mindate, maxdate=maxdate, disabledforeground='red',\n cursor=\"hand1\", year=2018, month=2, day=5)\n cal.pack(fill=\"both\", expand=True)\n ttk.Button(top, text=\"ok\", command=print_sel).pack()\n\n\n def example2():\n\n top = tk.Toplevel(root)\n\n cal = Calendar(top, selectmode='none')\n date = cal.datetime.today() + cal.timedelta(days=2)\n cal.calevent_create(date, 'Hello World', 'message')\n cal.calevent_create(date, 'Reminder 2', 'reminder')\n cal.calevent_create(date + cal.timedelta(days=-2), 'Reminder 1', 'reminder')\n cal.calevent_create(date + cal.timedelta(days=3), 'Message', 'message')\n\n cal.tag_config('reminder', background='red', foreground='yellow')\n\n cal.pack(fill=\"both\", expand=True)\n ttk.Label(top, text=\"Hover over the events.\").pack()\n\n\n def example3():\n top = tk.Toplevel(root)\n\n ttk.Label(top, text='Choose date').pack(padx=10, pady=10)\n\n cal = DateEntry(top, width=12, background='darkblue',\n foreground='white', borderwidth=2, year=2010)\n cal.pack(padx=10, pady=10)\n\n\n root = tk.Tk()\n ttk.Button(root, text='Calendar', command=example1).pack(padx=10, pady=10)\n ttk.Button(root, text='Calendar with events', command=example2).pack(padx=10, pady=10)\n ttk.Button(root, text='DateEntry', command=example3).pack(padx=10, pady=10)\n\n root.mainloop()\n\n\n\n.. |Release| image:: https://badge.fury.io/py/tkcalendar.svg\n :alt: Latest Release\n :target: https://pypi.org/project/tkcalendar/\n.. |Linux| image:: https://img.shields.io/badge/platform-Linux-blue.svg\n :alt: Platform\n.. |Windows| image:: https://img.shields.io/badge/platform-Windows-blue.svg\n :alt: Platform\n.. |Mac| image:: https://img.shields.io/badge/platform-Mac-blue.svg\n :alt: Platform\n.. |Travis| image:: https://travis-ci.org/j4321/tkcalendar.svg?branch=master\n :target: https://travis-ci.org/j4321/tkcalendar\n :alt: Travis CI Build Status\n.. |Appveyor| image:: https://ci.appveyor.com/api/projects/status/9a5bi9ewvccdmo3a/branch/master?svg=true\n :target: https://ci.appveyor.com/project/j4321/tkcalendar/branch/master\n :alt: Appveyor Build Status\n.. |Codecov| image:: https://codecov.io/gh/j4321/tkcalendar/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/j4321/tkcalendar\n :alt: Code coverage\n.. |License| image:: https://img.shields.io/github/license/j4321/tkcalendar.svg\n :target: https://www.gnu.org/licenses/gpl-3.0.en.html\n :alt: License\n.. |Doc| image:: https://readthedocs.org/projects/tkcalendar/badge/?version=latest\n :target: https://tkcalendar.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Calendar and DateEntry widgets for Tkinter",
"version": "1.6.1",
"project_urls": {
"Homepage": "https://github.com/j4321/tkcalendar"
},
"split_keywords": [
"tkinter",
"calendar",
"date"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "52a898b46185dad6be3fea2ea4f7f7e114de31ae5bc42d86c0b37525c4648a71",
"md5": "d7479a8cb2f4fdb5772d7bf3ef238ee9",
"sha256": "c3ac34ab268734377ce73407893e8a5765e288aecbbb55136fb3ccea98006a96"
},
"downloads": -1,
"filename": "tkcalendar-1.6.1-py3.8.egg",
"has_sig": false,
"md5_digest": "d7479a8cb2f4fdb5772d7bf3ef238ee9",
"packagetype": "bdist_egg",
"python_version": "3.8",
"requires_python": null,
"size": 28525,
"upload_time": "2019-12-28T11:20:51",
"upload_time_iso_8601": "2019-12-28T11:20:51.314140Z",
"url": "https://files.pythonhosted.org/packages/52/a8/98b46185dad6be3fea2ea4f7f7e114de31ae5bc42d86c0b37525c4648a71/tkcalendar-1.6.1-py3.8.egg",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e9d49528ea6ecb5d4394f425df651957da6f6a715b41c5b12d43d41888c14394",
"md5": "3d484d7501df0258b0c00066b19f5bf0",
"sha256": "9d3a80816a7b32d64fab696fa3d2a007fb23c87953267d5e343a38ff4cd7c15c"
},
"downloads": -1,
"filename": "tkcalendar-1.6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d484d7501df0258b0c00066b19f5bf0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 40912,
"upload_time": "2019-12-28T11:20:48",
"upload_time_iso_8601": "2019-12-28T11:20:48.564497Z",
"url": "https://files.pythonhosted.org/packages/e9/d4/9528ea6ecb5d4394f425df651957da6f6a715b41c5b12d43d41888c14394/tkcalendar-1.6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "653d3406cf7963661ed890082bff17ed4c5e26b5a564306639303d4fbb2a047f",
"md5": "472921d7e65b3ab24a687b50f19a7a44",
"sha256": "5edf958c0a59429e90309e9b805b2e229192bbcab952460247204d7030eea5cf"
},
"downloads": -1,
"filename": "tkcalendar-1.6.1.tar.gz",
"has_sig": false,
"md5_digest": "472921d7e65b3ab24a687b50f19a7a44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 32916,
"upload_time": "2019-12-28T11:20:54",
"upload_time_iso_8601": "2019-12-28T11:20:54.019087Z",
"url": "https://files.pythonhosted.org/packages/65/3d/3406cf7963661ed890082bff17ed4c5e26b5a564306639303d4fbb2a047f/tkcalendar-1.6.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2019-12-28 11:20:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "j4321",
"github_project": "tkcalendar",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"appveyor": true,
"lcname": "tkcalendar"
}
JSON
