Traducción no oficial al español rioplatense, generada con IA (Claude Sonnet 5.5) bajo la dirección y revisión de Jassiel Ovando. No es una publicación de Typst GmbH ni cuenta con su aval; ante cualquier duda, prevalece la documentación oficial en inglés. ¿Un error de traducción o una sugerencia? Reportalo. Tipografía: Reforma, de PampaType.

datetimeDesde: 0.5.0Ir al código fuente

Representa una fecha, una hora o una combinación de ambas.

Se puede crear especificando una fecha y hora personalizadas con la función constructora de este tipo u obteniendo la fecha actual con datetime.today.

Ejemplo

#let date = datetime(
  year: 2020,
  month: 10,
  day: 4,
)

#date.display() \
#date.display(
  "y:[year repr:last_two]"
)

#let time = datetime(
  hour: 18,
  minute: 2,
  second: 23,
)

#time.display() \
#time.display(
  "h:[hour repr:12][period]"
)

Datetime y Duration

Podés obtener una duración restando dos datetime:

#let first-of-march = datetime(day: 1, month: 3, year: 2024)
#let first-of-jan = datetime(day: 1, month: 1, year: 2024)
#let distance = first-of-march - first-of-jan
#distance.hours()

También podés sumar o restar una duración a un datetime para obtener un nuevo datetime desplazado:

#let date = datetime(day: 1, month: 3, year: 2024)
#let two-days = duration(days: 2)
#let two-days-earlier = date - two-days
#let two-days-later = date + two-days

#date.display() \
#two-days-earlier.display() \
#two-days-later.display()

Formato

Podés especificar un formato personalizado con el método display. El formato de un datetime se especifica proporcionando componentes con una cantidad determinada de modificadores. Un componente representa una cierta parte del datetime que querés mostrar y, con la ayuda de los modificadores, podés definir cómo querés mostrar ese componente. Para mostrar un componente, encerrás el nombre del componente entre corchetes (por ejemplo, [year] mostrará el año). Para agregar modificadores, agregás un espacio después del nombre del componente seguido del nombre del modificador, dos puntos y el valor del modificador (por ejemplo, [month repr:short] mostrará la representación corta del mes).

La combinación posible de componentes y sus respectivos modificadores es la siguiente:

Mirá acá para más detalles sobre la sintaxis admitida.

Tené en cuenta que no siempre se pueden usar todos los componentes. Por ejemplo, si creás un nuevo datetime con datetime(year: 2023, month: 10, day: 13), se almacenará internamente como una fecha simple, lo que significa que no podés usar componentes como hour o minute, que solo funcionarían en datetimes que tienen una hora especificada.

Constructor
Signo de pregunta
Ir al código fuente

Crea un datetime nuevo.

Podés especificar el datetime con año, mes, día, hora, minuto y segundo.

Nota: Según qué componentes del datetime especifiques, Typst lo almacenará de una de las tres maneras siguientes:

Según cómo se almacene, el método display elegirá por defecto un formato distinto.

ExpandirVer ejemplo
#datetime(
  year: 2012,
  month: 8,
  day: 3,
).display()
datetime(
year: int,month: int,day: int,hour: int,minute: int,second: int,
) → datetime

year
int

El año del datetime.

month
int

El mes del datetime.

day
int

El día del datetime.

hour
int

La hora del datetime.

minute
int

El minuto del datetime.

second
int

El segundo del datetime.

Funciones
Signo de pregunta

todayDesde: 0.5.0Ir al código fuente

Devuelve la fecha actual.

En la CLI, esto se puede reemplazar con el argumento --creation-timestamp o estableciendo la variable de entorno SOURCE_DATE_EPOCH. En ambos casos, el valor debe darse como una marca de tiempo UNIX.

ExpandirVer ejemplo
Today's date is
#datetime.today().display().
datetime.today(offset: autointduration) → datetime

offset
auto o int o duration
Por defecto: auto

Un desfase que se aplica a la fecha UTC actual. Si se establece en auto, el desfase será el local.

Cuando se da un desfase entero, se trata como una duración en horas.

displayDesde: 0.5.0Ir al código fuente

Muestra el datetime en un formato especificado.

Según hayas definido solo una fecha, solo una hora o ambas, el formato por defecto será distinto. Si especificaste una fecha, será [year]-[month]-[day]. Si especificaste una hora, será [hour]:[minute]:[second]. En el caso de un datetime, será [year]-[month]-[day] [hour]:[minute]:[second].

Mirá la sintaxis de formato para más información.

self.display(autostr) → str

pattern
auto o str
Posicional
Signo de pregunta
Por defecto: auto

El formato que se usa para mostrar el datetime.

yearDesde: 0.5.0Ir al código fuente

El año si se especificó, o none para horas sin fecha.

self.year() → noneint

monthDesde: 0.5.0Ir al código fuente

El mes si se especificó, o none para horas sin fecha.

self.month() → noneint

weekdayDesde: 0.5.0Ir al código fuente

El día de la semana (contando el lunes como 1) o none para horas sin fecha.

self.weekday() → noneint

dayDesde: 0.5.0Ir al código fuente

El día si se especificó, o none para horas sin fecha.

self.day() → noneint

hourDesde: 0.5.0Ir al código fuente

La hora si se especificó, o none para fechas sin hora.

self.hour() → noneint

minuteDesde: 0.5.0Ir al código fuente

El minuto si se especificó, o none para fechas sin hora.

self.minute() → noneint

secondDesde: 0.5.0Ir al código fuente

El segundo si se especificó, o none para fechas sin hora.

self.second() → noneint

ordinalDesde: 0.5.0Ir al código fuente

El ordinal (día del año), o none para horas sin fecha.

self.ordinal() → noneint