In Python, puoi ottenere e generare calendari come testo normale, HTML o un elenco con il modulo calendario nella libreria standard.
In questo articolo vengono descritti i seguenti contenuti.
- Ottieni/produci i calendari come testo normale
- Calendario mensile
- Calendario annuale
- Imposta il primo giorno della settimana
- Cambia i nomi delle impostazioni locali e dei giorni della settimana
- Ottieni/produci calendari come tabella HTML
- Calendario mensile
- Calendario annuale
- Imposta classi CSS
- Imposta il primo giorno della settimana
- Cambia i nomi delle impostazioni locali e dei giorni della settimana
- Ottieni i calendari come elenco
- Elenco di numeri
- Elenco di tuple
- Elenco di datetime.date
- Sulla riga di comando
Il calendario modulo fornisce anche funzioni utili per gli anni bisestili.
Ottieni/produci i calendari come testo normale
Calendario mensile
Puoi ottenere il calendario di qualsiasi anno e mese come stringa (str) con calendar.month().
import calendar
print(calendar.month(2019, 1))
# January 2019
# Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
#
print(type(calendar.month(2019, 1)))
# <class 'str'>
La larghezza della colonna può essere specificata con il parametro we la larghezza della riga con il parametro l.
print(calendar.month(2019, 1, w=3, l=2))
# January 2019
#
# Mon Tue Wed Thu Fri Sat Sun
#
# 1 2 3 4 5 6
#
# 7 8 9 10 11 12 13
#
# 14 15 16 17 18 19 20
#
# 21 22 23 24 25 26 27
#
# 28 29 30 31
#
#
La stessa stringa può essere emessa con calendar.prmonth().
calendar.prmonth(2019, 1)
# January 2019
# Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
Calendario annuale
calendar.calendar() fornisce il calendario annuale.
print(calendar.calendar(2019))
# 2019
#
# January February March
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 1 2 3 1 2 3
# 7 8 9 10 11 12 13 4 5 6 7 8 9 10 4 5 6 7 8 9 10
# 14 15 16 17 18 19 20 11 12 13 14 15 16 17 11 12 13 14 15 16 17
# 21 22 23 24 25 26 27 18 19 20 21 22 23 24 18 19 20 21 22 23 24
# 28 29 30 31 25 26 27 28 25 26 27 28 29 30 31
#
# April May June
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 7 1 2 3 4 5 1 2
# 8 9 10 11 12 13 14 6 7 8 9 10 11 12 3 4 5 6 7 8 9
# 15 16 17 18 19 20 21 13 14 15 16 17 18 19 10 11 12 13 14 15 16
# 22 23 24 25 26 27 28 20 21 22 23 24 25 26 17 18 19 20 21 22 23
# 29 30 27 28 29 30 31 24 25 26 27 28 29 30
#
# July August September
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 7 1 2 3 4 1
# 8 9 10 11 12 13 14 5 6 7 8 9 10 11 2 3 4 5 6 7 8
# 15 16 17 18 19 20 21 12 13 14 15 16 17 18 9 10 11 12 13 14 15
# 22 23 24 25 26 27 28 19 20 21 22 23 24 25 16 17 18 19 20 21 22
# 29 30 31 26 27 28 29 30 31 23 24 25 26 27 28 29
# 30
#
# October November December
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 1 2 3 1
# 7 8 9 10 11 12 13 4 5 6 7 8 9 10 2 3 4 5 6 7 8
# 14 15 16 17 18 19 20 11 12 13 14 15 16 17 9 10 11 12 13 14 15
# 21 22 23 24 25 26 27 18 19 20 21 22 23 24 16 17 18 19 20 21 22
# 28 29 30 31 25 26 27 28 29 30 23 24 25 26 27 28 29
# 30 31
#
print(type(calendar.calendar(2019)))
# <class 'str'>
È possibile specificare il numero di mesi da produrre per riga con il parametro m. Il valore predefinito è tre mesi per riga (= tre colonne). Inoltre, è possibile specificare il numero di spazi tra i mesi con il parametro c.
se omesso nell’esempio seguente, puoi specificare la larghezza di righe e colonne all’interno di ogni mese con parametri wel come calendar.month().
print(calendar.calendar(2019, c=3, m=4))
# 2019
#
# January February March April
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 1 2 3 1 2 3 1 2 3 4 5 6 7
# 7 8 9 10 11 12 13 4 5 6 7 8 9 10 4 5 6 7 8 9 10 8 9 10 11 12 13 14
# 14 15 16 17 18 19 20 11 12 13 14 15 16 17 11 12 13 14 15 16 17 15 16 17 18 19 20 21
# 21 22 23 24 25 26 27 18 19 20 21 22 23 24 18 19 20 21 22 23 24 22 23 24 25 26 27 28
# 28 29 30 31 25 26 27 28 25 26 27 28 29 30 31 29 30
#
# May June July August
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 1 2 1 2 3 4 5 6 7 1 2 3 4
# 6 7 8 9 10 11 12 3 4 5 6 7 8 9 8 9 10 11 12 13 14 5 6 7 8 9 10 11
# 13 14 15 16 17 18 19 10 11 12 13 14 15 16 15 16 17 18 19 20 21 12 13 14 15 16 17 18
# 20 21 22 23 24 25 26 17 18 19 20 21 22 23 22 23 24 25 26 27 28 19 20 21 22 23 24 25
# 27 28 29 30 31 24 25 26 27 28 29 30 29 30 31 26 27 28 29 30 31
#
# September October November December
# Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su
# 1 1 2 3 4 5 6 1 2 3 1
# 2 3 4 5 6 7 8 7 8 9 10 11 12 13 4 5 6 7 8 9 10 2 3 4 5 6 7 8
# 9 10 11 12 13 14 15 14 15 16 17 18 19 20 11 12 13 14 15 16 17 9 10 11 12 13 14 15
# 16 17 18 19 20 21 22 21 22 23 24 25 26 27 18 19 20 21 22 23 24 16 17 18 19 20 21 22
# 23 24 25 26 27 28 29 28 29 30 31 25 26 27 28 29 30 23 24 25 26 27 28 29
# 30 30 31
#
La stessa stringa può essere emessa con calendar.prcal(). L’uscita è omesso qui.
Imposta il primo giorno della settimana
Come negli esempi precedenti, i calendari hanno lunedì come primo giorno della settimana per la previsione predefinita.
Puoi impostare qualsiasi primo giorno della settimana con calendar.setfirstweekday().
calendar.setfirstweekday(calendar.SUNDAY)
print(calendar.month(2019, 1))
# January 2019
# Su Mo Tu We Th Fr Sa
# 1 2 3 4 5
# 6 7 8 9 10 11 12
# 13 14 15 16 17 18 19
# 20 21 22 23 24 25 26
# 27 28 29 30 31
#
I calendar.MONDAY e calendar.SUNDAY sono alias, dove MONDAY è 0 e SUNDAY è 6. Puoi specificare un valore intero per calendar.setfirstweekday().
Puoi controllare le impostazioni correnti con calendar.firstweekday().
print(calendar.MONDAY)
# 0
print(calendar.SUNDAY)
# 6
calendar.setfirstweekday(0)
print(calendar.month(2019, 1))
# January 2019
# Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
#
print(calendar.firstweekday())
# 0
Cambia i nomi delle impostazioni locali e dei giorni della settimana
I nomi dei giorni della settimana dalla località.
Creando un oggetto calendar.LocaleTextCalendar con la locale e chiamando i suoi vari metodi, puoi generare calendari con nomi di giorni della settimana corrispondenti a quella locale. Nell’esempio seguente, è impostato su tedesco.
ltc_de = calendar.LocaleTextCalendar(locale='de_de')
print(ltc_de.formatmonth(2019, 1))
# Januar 2019
# Mo Di Mi Do Fr Sa So
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
#
calendar.LocaleTextCalendar ha i seguenti metodi. I parametri wel possono essere specificati per un calendario mensile ei parametri cem aggiuntivi possono essere specificati per un calendario annuale.
- formatmonth(): si aggiorna una stringa di calendario mensile
- prmonth(): stampa un calendario mensile
- formatyear(): contiene una stringa di calendario annuale
- pryear(): stampa un calendario annuale
Si noti che la larghezza dei caratteri a doppio byte non viene presa in considerazione.
ltc_ja = calendar.LocaleTextCalendar(locale='ja_jp')
print(ltc_ja.formatmonth(2019, 1))
# 1月 2019
# 月 火 水 木 金 土 日
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
#
Ottieni/produci calendari come tabella HTML
Puoi ottenere il calendario come tabella HTML creando un oggetto calendar.HTMLCalendar e chiamando i vari metodi.
hc = calendar.HTMLCalendar()
Calendario mensile
Usa formatmonth() per un calendario mensile. È possibile specificare se visualizzare l’anno nell’intestazione con il parametro withyear (Default:True).
print(hc.formatmonth(2019, 1, withyear=False))
# <table border="0" cellpadding="0" cellspacing="0" class="month">
# <tr><th colspan="7" class="month">January</th></tr>
# <tr><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th><th class="sun">Sun</th></tr>
# <tr><td class="noday"> </td><td class="tue">1</td><td class="wed">2</td><td class="thu">3</td><td class="fri">4</td><td class="sat">5</td><td class="sun">6</td></tr>
# <tr><td class="mon">7</td><td class="tue">8</td><td class="wed">9</td><td class="thu">10</td><td class="fri">11</td><td class="sat">12</td><td class="sun">13</td></tr>
# <tr><td class="mon">14</td><td class="tue">15</td><td class="wed">16</td><td class="thu">17</td><td class="fri">18</td><td class="sat">19</td><td class="sun">20</td></tr>
# <tr><td class="mon">21</td><td class="tue">22</td><td class="wed">23</td><td class="thu">24</td><td class="fri">25</td><td class="sat">26</td><td class="sun">27</td></tr>
# <tr><td class="mon">28</td><td class="tue">29</td><td class="wed">30</td><td class="thu">31</td><td class="noday"> </td><td class="noday"> </td><td class="noday"> </td></tr>
# </table>
#
print(type(hc.formatmonth(2019, 1)))
# <class 'str'>
Calendario annuale
Usa formatyear() per un calendario annuale. È possibile specificare il numero di mesi da visualizzare per riga con il parametro larghezza (impostazione predefinita:3).
L’uscita è omesso qui.
print(hc.formatyear(2019, width=4))
Imposta classi CSS
Come visto negli esempi precedenti, le classi CSS sono impostate per ogni giorno della settimana.
I nomi delle classi vengono archiviati come un elenco nell’attributo cssclasses. È possibile impostare i nomi delle classi assegnando un nuovo elenco. Se chiami formatmonth() o formatyear() dopo la modifica, puoi ottenere HTML con nuovi nomi di classe.
print(hc.cssclasses)
# ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
hc.cssclasses = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat blue', 'sun red']
Da Python 3.7 sono stati aggiunti anche gli attributi di classe CSS per mesi, anni e giorni inesistenti. Questi possono anche essere modificati con nuovi valori.
print(hc.cssclass_month)
# month
print(hc.cssclass_year)
# year
print(hc.cssclass_noday)
# noday
Imposta il primo giorno della settimana
È possibile specificare il primo giorno della settimana con il parametro firstweekday di calendar.HTMLCalendar().
hc_sun = calendar.HTMLCalendar(firstweekday=6)
print(hc_sun.formatmonth(2019, 1))
# <table border="0" cellpadding="0" cellspacing="0" class="month">
# <tr><th colspan="7" class="month">January 2019</th></tr>
# <tr><th class="sun">Sun</th><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th></tr>
# <tr><td class="noday"> </td><td class="noday"> </td><td class="tue">1</td><td class="wed">2</td><td class="thu">3</td><td class="fri">4</td><td class="sat">5</td></tr>
# <tr><td class="sun">6</td><td class="mon">7</td><td class="tue">8</td><td class="wed">9</td><td class="thu">10</td><td class="fri">11</td><td class="sat">12</td></tr>
# <tr><td class="sun">13</td><td class="mon">14</td><td class="tue">15</td><td class="wed">16</td><td class="thu">17</td><td class="fri">18</td><td class="sat">19</td></tr>
# <tr><td class="sun">20</td><td class="mon">21</td><td class="tue">22</td><td class="wed">23</td><td class="thu">24</td><td class="fri">25</td><td class="sat">26</td></tr>
# <tr><td class="sun">27</td><td class="mon">28</td><td class="tue">29</td><td class="wed">30</td><td class="thu">31</td><td class="noday"> </td><td class="noday"> </td></tr>
# </table>
#
Nota che calendar.setfirstweekday() non funziona.
Cambia i nomi delle impostazioni locali e dei giorni della settimana
Se desideri modificare le impostazioni locali, crea un oggetto calendar.LocaleHTMLCalendar. Gli stessi metodi sono forniti per l’oggetto.HTMLCalendar descritto sopra.
lhc = calendar.LocaleHTMLCalendar(firstweekday=6, locale='ja_jp')
print(lhc.formatmonth(2019, 1))
# <table border="0" cellpadding="0" cellspacing="0" class="month">
# <tr><th colspan="7" class="month">1月 2019</th></tr>
# <tr><th class="sun">日</th><th class="mon">月</th><th class="tue">火</th><th class="wed">水</th><th class="thu">木</th><th class="fri">金</th><th class="sat">土</th></tr>
# <tr><td class="noday"> </td><td class="noday"> </td><td class="tue">1</td><td class="wed">2</td><td class="thu">3</td><td class="fri">4</td><td class="sat">5</td></tr>
# <tr><td class="sun">6</td><td class="mon">7</td><td class="tue">8</td><td class="wed">9</td><td class="thu">10</td><td class="fri">11</td><td class="sat">12</td></tr>
# <tr><td class="sun">13</td><td class="mon">14</td><td class="tue">15</td><td class="wed">16</td><td class="thu">17</td><td class="fri">18</td><td class="sat">19</td></tr>
# <tr><td class="sun">20</td><td class="mon">21</td><td class="tue">22</td><td class="wed">23</td><td class="thu">24</td><td class="fri">25</td><td class="sat">26</td></tr>
# <tr><td class="sun">27</td><td class="mon">28</td><td class="tue">29</td><td class="wed">30</td><td class="thu">31</td><td class="noday"> </td><td class="noday"> </td></tr>
# </table>
#
Ottieni i calendari come elenco
Elenco di numeri
Puoi ottenere un calendario come un elenco bidimensionale (un elenco di elenchi) i cui elementi sono interi di date con calendar.monthcalendar(). I giorni che non esistono sono impostati su 0.
Questo esempio usa pprint.
import calendar
import pprint
pprint.pprint(calendar.monthcalendar(2019, 1))
# [[0, 1, 2, 3, 4, 5, 6],
# [7, 8, 9, 10, 11, 12, 13],
# [14, 15, 16, 17, 18, 19, 20],
# [21, 22, 23, 24, 25, 26, 27],
# [28, 29, 30, 31, 0, 0, 0]]
Puoi specificare il primo giorno della settimana con calendar.setfirstweekday().
calendar.setfirstweekday(6)
pprint.pprint(calendar.monthcalendar(2019, 1))
# [[0, 0, 1, 2, 3, 4, 5],
# [6, 7, 8, 9, 10, 11, 12],
# [13, 14, 15, 16, 17, 18, 19],
# [20, 21, 22, 23, 24, 25, 26],
# [27, 28, 29, 30, 31, 0, 0]]
Puoi ottenere lo stesso elenco creando un oggetto calendar.Calendar e chiamando il metodo monthdayscalendar(). In questo metodo è possibile specificare il primo giorno della settimana con il parametro firstweekday del costruttore calendar.Calendar().
c = calendar.Calendar(firstweekday=0)
pprint.pprint(c.monthdayscalendar(2019, 1))
# [[0, 1, 2, 3, 4, 5, 6],
# [7, 8, 9, 10, 11, 12, 13],
# [14, 15, 16, 17, 18, 19, 20],
# [21, 22, 23, 24, 25, 26, 27],
# [28, 29, 30, 31, 0, 0, 0]]
È possibile ottenere il calendario annuale con il metodo yeardayscalendar() dell’oggetto calendar.Calendar. Come per il testo normale e l’HTML, puoi specificare il numero di mesi per riga con il parametro width.
pprint.pprint(c.yeardayscalendar(2019), depth=2)
# [[[...], [...], [...]],
# [[...], [...], [...]],
# [[...], [...], [...]],
# [[...], [...], [...]]]
pprint.pprint(c.yeardayscalendar(2019, width=4), depth=2)
# [[[...], [...], [...], [...]],
# [[...], [...], [...], [...]],
# [[...], [...], [...], [...]]]
Elenco di tuple
Puoi ottenere un calendario come elenco di tuple con il metodo monthdays2calendar() di calendar.Calendar. Ogni tupla ha un valore di (data, giorno) e una data inesistente è 0.
pprint.pprint(c.monthdays2calendar(2019, 1))
# [[(0, 0), (1, 1), (2, 2), (3, 3), (4, 4), (5, 5), (6, 6)],
# [(7, 0), (8, 1), (9, 2), (10, 3), (11, 4), (12, 5), (13, 6)],
# [(14, 0), (15, 1), (16, 2), (17, 3), (18, 4), (19, 5), (20, 6)],
# [(21, 0), (22, 1), (23, 2), (24, 3), (25, 4), (26, 5), (27, 6)],
# [(28, 0), (29, 1), (30, 2), (31, 3), (0, 4), (0, 5), (0, 6)]]
Usa yeardays2calendar() per il calendario annuale. Gli esempi sono omessi qui.
Elenco di datetime.date
Puoi ottenere un calendario come elenco di datetime.date con il metodo monthdatescalendar() di calendar.Calendar.
La prima e l’ultima settimana del mese include le date del mese precedente e successivo.
pprint.pprint(c.monthdatescalendar(2019, 1))
# [[datetime.date(2018, 12, 31),
# datetime.date(2019, 1, 1),
# datetime.date(2019, 1, 2),
# datetime.date(2019, 1, 3),
# datetime.date(2019, 1, 4),
# datetime.date(2019, 1, 5),
# datetime.date(2019, 1, 6)],
# [datetime.date(2019, 1, 7),
# datetime.date(2019, 1, 8),
# datetime.date(2019, 1, 9),
# datetime.date(2019, 1, 10),
# datetime.date(2019, 1, 11),
# datetime.date(2019, 1, 12),
# datetime.date(2019, 1, 13)],
# [datetime.date(2019, 1, 14),
# datetime.date(2019, 1, 15),
# datetime.date(2019, 1, 16),
# datetime.date(2019, 1, 17),
# datetime.date(2019, 1, 18),
# datetime.date(2019, 1, 19),
# datetime.date(2019, 1, 20)],
# [datetime.date(2019, 1, 21),
# datetime.date(2019, 1, 22),
# datetime.date(2019, 1, 23),
# datetime.date(2019, 1, 24),
# datetime.date(2019, 1, 25),
# datetime.date(2019, 1, 26),
# datetime.date(2019, 1, 27)],
# [datetime.date(2019, 1, 28),
# datetime.date(2019, 1, 29),
# datetime.date(2019, 1, 30),
# datetime.date(2019, 1, 31),
# datetime.date(2019, 2, 1),
# datetime.date(2019, 2, 2),
# datetime.date(2019, 2, 3)]]
Usa yeardatescalendar() per un calendario annuale. Gli esempi sono omessi qui.
Sulla riga di comando
Il modulo calendario è disponibile anche sulla riga di comando.
Chiama il calendario come modulo con il comando python (o python3 in alcuni ambienti) con l’opzione -m.
python3 -m calendar 2019 1
# January 2019
# Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6
# 7 8 9 10 11 12 13
# 14 15 16 17 18 19 20
# 21 22 23 24 25 26 27
# 28 29 30 31
Sono disponibili anche varie opzioni.
python3 -m calendar -h
# usage: calendar.py [-h] [-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS]
# [-c CSS] [-L LOCALE] [-e ENCODING] [-t {text,html}]
# [year] [month]
#
# positional arguments:
# year year number (1-9999)
# month month number (1-12, text only)
#
# optional arguments:
# -h, --help show this help message and exit
# -L LOCALE, --locale LOCALE
# locale to be used from month and weekday names
# -e ENCODING, --encoding ENCODING
# encoding to use for output
# -t {text,html}, --type {text,html}
# output type (text or html)
#
# text only arguments:
# -w WIDTH, --width WIDTH
# width of date column (default 2)
# -l LINES, --lines LINES
# number of lines for each week (default 1)
# -s SPACING, --spacing SPACING
# spacing between months (default 6)
# -m MONTHS, --months MONTHS
# months per row (default 3)
#
# html only arguments:
# -c CSS, --css CSS CSS to use for page