Determina la hora de uno o más valores de tiempo del calendario como un valor de intervalo de tiempo o genera un valor de intervalo de tiempo utilizando los elementos especificados.
Sintaxis
Time(CalendarTime)
o
Time(CalendarTime, Timezone)
o
Time(Hours, Minutes, Seconds)
o
Time(Days, Hours, Minutes, Seconds)
La sintaxis de la función Time consta de los siguientes elementos:
Parte |
Descripción |
|---|---|
CalendarTime |
Es el valor de tiempo del calendario del que debe extraerse la hora. Si el argumento no representa un valor de tiempo del calendario válido, se emite un valor en coma flotante inválido. Las estructuras de datos permitidas son Valor escalar, Serie de datos y Matriz de datos. Se permiten todos los tipos de datos reales excepto Intervalo de tiempo. El argumento se transforma en la unidad s. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
Timezone |
Es la zona horaria para la que debe determinarse el resultado como desfase respecto al Tiempo Universal Coordinado (UTC) en horas. Si omite el argumento, el resultado se determina en la hora local. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Entero de 16 bits, Entero de 32 bits, Entero de 64 bits, En coma flotante de 32 bits, En coma flotante de 64 bits y Intervalo de tiempo. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Days |
Es el número de días del intervalo de tiempo. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales. El argumento se transforma en la unidad d. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Hours |
Es el número de horas del intervalo de tiempo. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales. El argumento se transforma en la unidad h. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Minutes |
Es el número de minutos del intervalo de tiempo. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales. El argumento se transforma en la unidad min. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Seconds |
Es el número de segundos del intervalo de tiempo. Las estructuras de datos permitidas son Valor escalar y Serie de datos. Se permiten todos los tipos de datos reales. El argumento se transforma en la unidad s. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Notas
El tipo de datos del resultado es siempre Intervalo de tiempo.
La estructura del resultado corresponde a la del argumento CalendarTime, si es necesario, el cálculo se realiza elemento por elemento.
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
Time('2.3.04 12:13:14') |
Devuelve '12:13:14'. |
Time(CurrentDate(), 0) |
Proporciona la hora actual en tiempo universal coordinado (UTC). |
Time(12, 30, 45.6) |
Devuelve '12:30:45.6'. |
Time(12, -30, 45.6) |
Devuelve '11:30:45.6'. |
-Time(12, 30, 45.6) |
Devuelve -'12:30:45.6'. |
Time(-12, -30, -45.6) |
Devuelve -'12:30:45.6'. |
Time(3, 12, 30, 45.6) |
Devuelve '3:12:30:45.6'. |
Time(3 d, 12 h, 30 min, 45 ms) |
Devuelve '3:12:30:00.045'. |