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