El mòdul `datetime` ==================== * Conté diverses classes. Les quatre més significatives són :py:class:`~datetime.date`, :py:class:`~datetime.time`, :py:class:`~datetime.datetime` i :py:class:`~datetime.timedelta`. * Manual de referència de Python: :py:mod:`datetime`. La classe `timedelta` --------------------- * Representa un interval temporal, positiu o negatiu, amb una precisió de microsegons. * Es pot crear amb diversos paràmetres opcionals (`days, hours, minutes, seconds`, ...) però només emmagatzema tres atributs: `days`, `seconds` i `microseconds`. Cap d'ells es pot modificar, només consultar (són només de lectura, `readonly`). * Suporta diverses operacions: suma, resta, divisió, abs(), comparació, etc. * Disposa del mètode :py:func:`~datetime.timdelta.total_seconds`. La classe `date` ---------------- * Representa una data, és a dir, un dia d'un mes i any concrets en el calendari gregorià (l'habitual). * Es crea a patir de tres enters: any, mes i dia. Si s'intenta crear una data incorrecta, es produeix un error. això té en compte els anys de traspàs. Emmagatzema tres atributs només de lectura: `year`, `month` i `day`. * Es poden comparar dates, per veure si una és anterior a una altra. També es poden restar dates, donant lloc a un interval de temps (:py:class:`~datetime.timedelta`), per calcular quants temps ha passat entre dues dates, així com sumar o restar un interval de temps a una data. * D'entre els mètodes de què disposa, destaquem :py:meth:`~datetime.date.weekday`, que serveix per calcular en quin dia de la setmana cau una data. * :py:meth:`datetime.date.today` serveix per obtenir la data actual. La classe `time` ---------------- * Representa un instant de temps d'un dia indeterminat. * Consulteu el manual de referència per a saber com fer servir aquesta classe. Destaquem que: - Els quatre atributs més importants són `hour`, `minute`, `second` i `microsecond`, només de lectura. - Es poden comparar dos :py:class:`datetime.time` però **no es poden restar** per obtenir un interval de temps. En lloc d'això, haurem d'operar entre dos :py:class:`datetime.datetime`. La classe `datetime` -------------------- * Representa un instant d'un dia concret. Ve a ser la "unió" d'una :py:class:`datetime.date` i una :py:class:`datetime.time`. * Consulteu el manual de referència per a saber com fer servir aquesta classe. Destaquem que: - :py:meth:`datetime.datetime.now` retorna l'instant actual. - Hi ha moltes maneres de transformar una data a string, amb diversos formats (DD/MM/AAAA, per exemple); vegeu :py:meth:`datetime.datetime.strftime`. .. rubric:: Exemples d'ús: Consulteu la documentació de referència del mòdul.