#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.

Te sugerimos utilizar este helper para enviar las fechas en tu zona horaria local. Videsk envía por defecto en UTC.

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.

Recuerda que el formato de las opciones es en JSON, cada nombre de opción deberá tener comillas dobles.

Ejemplos de uso

Datos de ejemplo

{
    "startedAt": "2021-10-01T05:51:36.000Z"
}

UTC a hora Santiago

{{#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.

Opciones por defecto

{
    "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.

Las opciones disponibles actualizadas siempre las podrás encontrar acá.

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.

El listado de zonas horarias disponibles lo podrás encontrar acá TimezoneDB.

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:

hourCycle	Descripción
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}}

Para más información sobre el uso de @root o this haz clic aquí.

Formatos locales disponibles

Language Tag	Language	Region	Description
ar-SA	Arabic	Saudi Arabia	Arabic (Saudi Arabia)
bn-BD	Bangla	Bangladesh	Bangla (Bangladesh)
bn-IN	Bangla	India	Bangla (India)
cs-CZ	Czech	Czech Republic	Czech (Czech Republic)
da-DK	Danish	Denmark	Danish (Denmark)
de-AT	German	Austria	Austrian German
de-CH	German	Switzerland	"Swiss" German
de-DE	German	Germany	Standard German (as spoken in Germany)
el-GR	Greek	Greece	Modern Greek
en-AU	English	Australia	Australian English
en-CA	English	Canada	Canadian English
en-GB	English	United Kingdom	British English
en-IE	English	Ireland	Irish English
en-IN	English	India	Indian English
en-NZ	English	New Zealand	New Zealand English
en-US	English	United States	US English
en-ZA	English	South Africa	English (South Africa)
es-AR	Spanish	Argentina	Argentine Spanish
es-CL	Spanish	Chile	Chilean Spanish
es-CO	Spanish	Colombia	Colombian Spanish
es-ES	Spanish	Spain	Castilian Spanish (as spoken in Central-Northern Spain)
es-MX	Spanish	Mexico	Mexican Spanish
es-US	Spanish	United States	American Spanish
fi-FI	Finnish	Finland	Finnish (Finland)
fr-BE	French	Belgium	Belgian French
fr-CA	French	Canada	Canadian French
fr-CH	French	Switzerland	"Swiss" French
fr-FR	French	France	Standard French (especially in France)
he-IL	Hebrew	Israel	Hebrew (Israel)
hi-IN	Hindi	India	Hindi (India)
hu-HU	Hungarian	Hungary	Hungarian (Hungary)
id-ID	Indonesian	Indonesia	Indonesian (Indonesia)
it-CH	Italian	Switzerland	"Swiss" Italian
it-IT	Italian	Italy	Standard Italian (as spoken in Italy)
ja-JP	Japanese	Japan	Japanese (Japan)
ko-KR	Korean	Republic of Korea	Korean (Republic of Korea)
nl-BE	Dutch	Belgium	Belgian Dutch
nl-NL	Dutch	The Netherlands	Standard Dutch (as spoken in The Netherlands)
no-NO	Norwegian	Norway	Norwegian (Norway)
pl-PL	Polish	Poland	Polish (Poland)
pt-BR	Portugese	Brazil	Brazilian Portuguese
pt-PT	Portugese	Portugal	European Portuguese (as written and spoken in Portugal)
ro-RO	Romanian	Romania	Romanian (Romania)
ru-RU	Russian	Russian Federation	Russian (Russian Federation)
sk-SK	Slovak	Slovakia	Slovak (Slovakia)
sv-SE	Swedish	Sweden	Swedish (Sweden)
ta-IN	Tamil	India	Indian Tamil
ta-LK	Tamil	Sri Lanka	Sri Lankan Tamil
th-TH	Thai	Thailand	Thai (Thailand)
tr-TR	Turkish	Turkey	Turkish (Turkey)
zh-CN	Chinese	China	Mainland China, simplified characters
zh-HK	Chinese	Hond Kong	Hong Kong, traditional characters
zh-TW	Chinese	Taiwan	Taiwan, traditional characters