Funciones de horas

Conjunto de Funciones de fórmula que nos permiten operar con datos de tipo hora.

addMSecondsToHour

Devuelve la hora incrementada los milisegundos.

addMSecondsToHour(hora, milisegundos)

Parámetros

• hora

  Expresión de tipo hora a la que queremos sumar los milisegundos. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

• milisegundos

  Milisegundos a sumar a la hora.

Ejemplo

HORA = 13:25:05:121 addMSecondsToHour( HORA, 10 ) = 13:25:05:131

addSecondsToHour

Devuelve la hora incrementada los segundos.

addSecondsToHour(hora, segundos)

Parámetros

• hora

  Expresión de tipo hora a la que queremos sumar los segundos. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

• segundos

  Segundos a sumar a la hora.

Ejemplo

HORA = 13:25:05:121 addSecondsToHour( HORA, 10 ) = 13:25:15:121

currentTime

Devuelve la hora actual

currentTime()

Parámetros

• No tiene.

Ejemplo

currentTime() = 17:08:01

hour

Devuelve las horas (0 a 23) de la hora

hour(hora)

Parámetros

• hora

  Expresión de tipo hora cuyo dato horas queremos obtener. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo

HORA = 20:19:08 hour(HORA) = 20

mSecond

Devuelve los milisegundos (0 a 999) de la hora.

mSecond(hora)

Parámetros

• hora

  Expresión de tipo hora cuyo dato milisegundos queremos obtener. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo

HORA = 20:19:08:111 mSecond( HORA ) = 111

minute

Devuelve los minutos (0 a 59) de la hora

minute(hora)

Parámetros

• hora

  Expresión de tipo hora cuyo dato minutos queremos obtener. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo

HORA = 20:19:08:111 minute( HORA ) = 19

second

Devuelve los segundos (0 a 59) de la hora.

second(hora)

Parámetros

• hora

  Expresión de tipo hora cuyo dato segundos queremos obtener. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo

HORA = 20:19:08:111 second( HORA ) = 8

setTime

Crea una hora.

setTime(hora, minuto, segundo)

Parámetros

• hora

  Dato hora con el que queremos componer la hora.

• minuto

  Dato minuto con el que queremos componer la hora.

• segundo

  Dato segundo con el que queremos componer la hora.

Ejemplo

setTime( 13, 25, 15 ) = 13:25:15

stringToTime

Convierte en hora una cadena según las indicaciones del formato.

stringToTime(cadena, cadenaFormato)

Parámetros

• cadena

  Cadena que contiene la hora.

• cadenaFormato

  Permite indicar cuál es el formato de la hora en la cadena. Cadenas de formato disponibles:

  • Horas: h (0-23, 1-12 AM/PM) hh (00-23, 01-12 AM/PM) H (0-23) HH (00-23).

  • Minutos: m (0-59) mm (00-59).

  • Segundos: s (0-59) ss (00-59) z (0-999) zzz (000-999).

  • Periodos: AP (AM/PM) ap (am/pm).

  El resto de caracteres en la cadena de formato serán tratados como texto. También los caracteres que estén entre comillas simples (‘) en la cadena de formato serán tratados como texto, lo que nos permite tratar los caracteres específicos de formato (h, hh, H, HH, m, mm, etc.) como texto.

Si la cadena no se corresponde con el formato especificado devolverá una hora nula, no devolverá nada. Esto puede incluir casos en los que se espere ceros por la izquierda u otras incoherencias con el formato esperado.

timeIsValid

Indica si la hora es válida (Si=1, No=0).

timeIsValid( hora )

Parámetros

• hora

  Expresión de tipo hora que queremos comprobar. Esta hora puede ser un literal, una variable, un campo, el retorno de una función, etc.

Ejemplo

HORA = 13:25:05 timeIsValid(HORA) = 1

timeToString

Devuelve la hora como una cadena según las indicaciones del formato.

timeToString(hora, cadenaFormato)

Parámetros

• hora

  Expresión de tipo hora que queremos formatear.

• cadenaFormato

  Cadena de formato que especifica cómo crear la cadena a partir de la hora. Cadenas de formato disponibles:

  • Horas: h (0-23, 1-12 AM/PM) hh (00-23, 01-12 AM/PM) H (0-23) HH (00-23).

  • Minutos: m (0-59) mm (00-59).

  • Segundos: s (0-59) ss (00-59) z (0-999) zzz (000-999).

  • Periodos: AP (AM/PM) ap (am/pm)