Python – método datetime.toordinal() con ejemplo

datetime.toordinal() es un método simple que se usa para manipular los objetos de la clase DateTime. Devuelve el ordinal gregoriano proléptico de la fecha, donde el 1 de enero del año 1 tiene el ordinal 1. La función devuelve el valor ordinal para el objeto DateTime dado.

Si el 1 de enero del año 1 tiene el ordinal 1 entonces, el 2 de enero del año 1 tendrá el ordinal 2, y así sucesivamente.

Sintaxis: 

datetimeObj.toordinal()

Parámetros: Ninguno

Devoluciones: valor ordinal

A continuación se presentan algunas implementaciones para el mismo.

Ejemplo 1: Use la función datetime.toordinal() para devolver el ordinal gregoriano para el objeto de fecha y hora dado usando la clase date.today() del módulo de fecha y hora.

# Python3 code to demonstrate
# Getting Ordinal value using
# toordinal().
 
# importing datetime module for today()
import datetime
 
# using date.today() to get todays date
dateToday = datetime.date.today()
 
# Using toordinal() to generate ordinal value.
toOrdinal = dateToday.toordinal()
 
# Prints Ordinal Value of Todays Date.
print(f"Ordinal of date {dateToday} is {toOrdinal}")

Ordinal of date 2021-08-03 is 738005

Nota: los atributos de la clase DateTime deben estar en el rango dado; de lo contrario, mostrará un ValueError

Ejemplo 2: Ejemplo para mostrar que los parámetros deben estar en el rango

# importing datetime class
from datetime import datetime
 
# Creating an instance of datetime.
dateIs = datetime(189, 0, 0)
 
# Using toordinal() method
toOrdinal = dateIs.toordinal()
print(f"Ordinal value of Earliest Datetime {dateIs} is {toOrdinal}")

Producción:

Rastreo (llamadas recientes más última):

  Archivo “/home/2ecd5f27fbc894dc8eeab3aa6559c7ab.py”, línea 5, en <módulo>

    fechaEs = fechahora(189,0,0)

ValueError: el mes debe estar en 1..12

Ejemplo 3: Use la función datetime.toordinal() para devolver el ordinal gregoriano para el objeto DateTime dado.

# importing datetime class
from datetime import datetime
 
# Creating an instance of datetime.
dateIs = datetime(1, 1, 1, 0, 0, 0, 0)
 
# Using toordinal() method
toOrdinal = dateIs.toordinal()
print(f"Ordinal value of Earliest Datetime {dateIs} is {toOrdinal}")
 
print()
 
dateIs = datetime(9999, 12, 31, 23, 59, 59)
toOrdinal = dateIs.toordinal()
print(f"Ordinal value of Latemost Datetime {dateIs} is {toOrdinal}")

Producción:

El valor ordinal de la fecha y hora más temprana 0001-01-01 00:00:00 es 1

El valor ordinal de la última fecha y hora 9999-12-31 23:59:59 es 3652059