#date
A continuación, podrás encontrar la documentación de como utilizar este helper.
Este tipo de helper tiene como utilidad transformar valores de un Date
(fechas) a diversos formatos y zonas horarias.
Los argumentos que recibe este helper son los siguientes:
Fecha
Formato (BCP 47 language tag)*
Luego dentro del helper podrás ingresar como un JSON con las opciones disponibles en la API de Javascript Intl.DateTimeFormat, opciones que darán el formato que necesites junto con el cambio de horario correspondiente a la zona horaria que ingreses.
Ejemplos de uso
{
"startedAt": "2021-10-01T05:51:36.000Z"
}
{{#date startedAt 'es-CL'}}
{
"year": "numeric",
"month": "numeric",
"day": "numeric",
"hour": "numeric",
"minute": "numeric",
"second": "numeric",
"timeZone": "America/Santiago"
}
{{/date}}
La salida de este helper será 01-10-2021, 02:51:36
.
Valores por defecto
Lee con detención los valores por defecto, ya que la salida de la fecha podría variar.
Por defecto, al usar este helper sin entregar opciones la zona horaria será UTC
y en el siguiente formato (en-US) 12/20/2020, 03:23:16
, equivalente a mes-dia-año, hora:minutos:segundos
.
Adicionalmente, añadimos por defecto las opciones con los siguientes valores, los cuáles son reemplazados solo si están definidos en tus opciones ingresadas.
{
"year": "numeric",
"month": "numeric",
"day": "numeric",
"hour": "2-digit",
"minute": "2-digit",
"second": "2-digit",
"hour12": false
}
Quitar valores por defecto
Si necesitas quitar valores del formato, podrás definirlos como null
, por ejemplo:
{{#date startedAt 'es-CL'}}
{ "weekday": null, "timeZone": "America/Mexico_City" }
{{/date}}
Esto provocará como en el ejemplo que weekday
no esté presente en el formato, pero el resto de opciones por defecto seguirán activas.
Opciones
Lee las opciones a continuación, cada una de ellas te permitirá realizar modificaciones en el formato, cálculo en base a calendario, zona horaria, etc.
El nombre de la opción es sensible a mayúsculas y minúsculas.
Recuerda que son opciones, puedes usar todas, algunas o ninguna.
timeZone
Corresponde a la zona horaria que deseas que la hora se calcule. Por defecto la hora en nuestros sistemas se almacenan en UTC, por lo que podrás realizar la conversión con esta opción.
Recuerda, se escribe timeZone
, no timezone
.
{{#date startedAt}}{ "timeZone": "America/Santiago" }{{/date}}
hour12
Podrás definir el formato de 24 horas (por defecto) o 12 horas.
{{#date startedAt}}{ "hour12": true }{{/date}}
hourCycle
Podrás escoger entre los siguientes formatos para la hora:
h12
El reloj de 12 horas, con la medianoche comenzando a las 12:00 am.
h23
El reloj de 24 horas, con la medianoche a partir de las 0:00.
h11
El reloj de 12 horas, con la medianoche a partir de las 0:00 am.
h24
El reloj de 24 horas, con la medianoche a partir de las 24:00.
{{#date startedAt}}{ "hourCycle": "h23" }{{/date}}
weekday
Te permitirá escoger como se mostrará el día de la semana, mediante los siguientes valores disponibles long
, short
, narrow
.
{{#date startedAt}}{ "weekday": "long" }{{/date}}
year
Formato del año ya sea 2022
o 22
. Los valores disponibles son numeric
y 2-digit
.
{{#date startedAt}}{ "year": "numeric" }{{/date}}
month
Formato del mes ya sea 1
, 01
, Enero
, Ene
, E
. Los valores disponibles son numeric
, 2-digit
, long
, short
, narrow
.
{{#date startedAt}}{ "month": "numeric" }{{/date}}
day
Formato del día ya sea 1
o 01
. Los valores disponibles son numeric
, 2-digit
.
{{#date startedAt}}{ "day": "numeric" }{{/date}}
hour
Formato de la hora ya sea 1
o 01
. Los valores disponibles son numeric
, 2-digit
.
{{#date startedAt}}{ "hour": "numeric" }{{/date}}
minute
Formato de los minutos ya sea 1
o 01
. Los valores disponibles son numeric
, 2-digit
.
{{#date startedAt}}{ "minute": "numeric" }{{/date}}
second
Formato de los segundos ya sea 1
o 01
. Los valores disponibles son numeric
, 2-digit
.
{{#date startedAt}}{ "second": "numeric" }{{/date}}
timeZoneName
Podrás definir el formato de salida de la zona horaria ya sea Pacific Standard Time
, GMT-8
, GMT-0800
, Los Angeles Zeit
, Pacific Time
. Los valores disponibles son long
, short
, shortOffset
, longOffset
, shortGeneric
, longGeneric
.
{{#date startedAt}}{ "timeZoneName": "short" }{{/date}}
dateStyle
Corresponde al formato de la fecha, sin incluir el tiempo (hora, minutos, segundos, etc). Los valores disponibles son full
, long
, medium
y short
.
{{#date startedAt}}{ "dateStyle": "full" }{{/date}}
timeStyle
Corresponse al formato de tiempo sin incluir (año, mes, dia). Los valores disponibles son full
, long
, medium
, short
.
{{#date startedAt}}{ "timeStyle": "full" }{{/date}}
calendar
Los valores disponibles son buddhist
, chinese
, coptic
, dangi
, ethioaa
, ethiopic
, gregory
, hebrew
, islamic
, indian
, islamic-umalqura
, islamic-tbla
, islamic-civil
, islamic-rgsa
, iso8601
, japanese
, persian
, roc
.
{{#date startedAt}}{ "calendar": "chinese" }{{/date}}
dayPeriod
Los valores disponibles son narrow
, short
, long
.
{{#date startedAt}}{ "dayPeriod": "long" }{{/date}}
numberingSystem
Los valores disponibles son arab
, arabext
, bali
, beng
, deva
, fullwide
, gujr
, guru
, hanidec
, khmr
, knda
, laoo
, latn
, limb
, mlym
, mong
, mymr
, orya
, tamldec
, telu
, thai
, tibt.
{{#date startedAt}}{ "numberingSystem": "fullwide" }{{/date}}
Última actualización
¿Te fue útil?