#relative

A continuación, podrás encontrar la documentación de como utilizar este helper.

Este tipo de helper tiene como utilidad transformar un fecha Date a texto humanamente legible de forma relativa. Ej: dentro 1 hora.

Te sugerimos utilizar este helper para enviar recordatorios con mensaje como "dentro 2 horas".

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.RelativeTimeFormat, 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

{{#relative startedAt 'es-CL'}}
    {
        "style": "long",
        "localeMatcher": "lookup",
    }
{{/relative}}

La salida de este helper será hace 3 años

---

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 el estilo (style) será long .

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

{
    "style": "long",
    "numeric": "auto",
    "localeMatcher": "best fit"
}

---

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

localeMatcher

Podrás definit el algoritmo de coincidencia regional que se utilizará. Los valores posibles son lookup y best fit, y el valor predeterminado es best fit.

{{#relative startedAt}}{ "localeMatcher": "best fit" }{{/relative}}

numberingSystem

Podrás definir el sistema de numeración que se utilizará para el formato de números, como arab, hans, mathsans, etc.

{{#relative startedAt}}{ "numberingSystem": "a" }{{/relative}}

style

Podrás escoger entre los siguientes formatos para la salida:

style	Ejemplo
long	dentro 1 mes
short	en 1 d.
narrow	en 2 mes.

{{#relative startedAt}}{ "style": "long" }{{/relative}}

numeric

Podrás definir si se deben utilizar valores numéricos en la salida. Los valores posibles son always y auto, y el valor predeterminado es always.

{{#relative startedAt}}{ "numeric": "always" }{{/relative}}

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