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.

Sintaxis

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.

Sintaxis

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

Sintaxis

currentTime()

Parámetros

No tiene.

Ejemplo

currentTime() = 17:08:01

hour

Devuelve las horas (0 a 23) de la hora

Sintaxis

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.

Sintaxis

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

Sintaxis

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.

Sintaxis

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.

Sintaxis

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.

Sintaxis

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.

Formato

  • 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 la 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).

Sintaxis

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.

Sintaxis

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.

Formato

  • 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)