# Time Función de script y de gráfico

Time() da formato a una expresión como un valor de hora, en el formato de tiempo definido en las variables de sistema del script de carga de datos, o en el sistema operativo, a menos que se suministre una cadena de formato.

Sintaxis:

Time(number[, format])

Tipo de datos que devuelve: dual

Argumentos

| Argumento | Descripción |
| --- | --- |
| number | El número al que se ha de dar formato. |
| format | Cadena que describe qué formato habrá de recibir la cadena de hora resultante. Si se omite, se utiliza el formato de hora y el separador decimal establecidos en el sistema operativo.<br><br>La función `Time` admite muchas opciones de formato para diferentes estructuras de tiempo, por ejemplo:<br><br>`hh:mm:ss` da formato a un valor de hora en un formato de hora estándar y muestra las horas, los minutos y los segundos con ceros a la izquierda.<br><br>`hh:mm TT` utiliza un formato de 12 horas con el sufijo AM/PM.<br><br>`hh:mm` muestra solo las horas y los minutos, omitiendo los segundos.<br><br>`hh.mm.ss` es un formato de hora con diferentes separadores, como un punto (`.`) en lugar de dos puntos.<br><br>`hh TT` incluye solo la hora y AM/PM.<br><br>`hh "Hrs" mm "Mins"` muestra la hora con un texto personalizado, como Hrs.<br><br>[Descripciones de formatos numéricos y de hora](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/conventions-number-time-formats.htm) |

Ejemplo: Expresiones de gráficos

| Ejemplo | Resultado |
| --- | --- |
| `Time( 0.375 )` | Devuelve `09:00:00` cuando la configuración de `TimeFormat` es `'hh:mm:ss'`. |
| `Time( 35648.375 )` | Devuelve `09:00:00` cuando el `Timeformat` suministrado es `'hh:mm:ss'`. |
| `Time( 0.99999, 'hh-mm' )` | Devuelve `23-59` ignorando el ajuste `TimeFormat` ya que el formato se suministra en la medida. |

## Ejemplo: fundamentos de Time

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)

#### Expresión de gráfico

Vista general

Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.

El script de carga contiene:

* Un conjunto de datos que se carga en una tabla de datos denominada `Example`.

* El siguiente campo en una tabla de datos:

  * `TimeValue`

* La variable `TimeFormat`, que utiliza el formato `hh:mm:ss`.

Script de carga

```
SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:

* ` TimeValue
                                       `

Cree las siguientes medidas:

* `=Time(TimeValue )`, para ver el valor como una hora con el formato utilizado en la configuración del sistema.

* `=Time(TimeValue, 'hh-mm' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm:ss' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm TT' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh.mm.ss' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh TT' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, para ver el valor como una hora con el formato suministrado en la función.

Tabla de resultados

| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 h 00 min |
| 0.99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 PM | 23:59 | 23.59.59 | 11 PM | 23 h 59 min |
| 35 648,375 | 09:00:00 | 09-00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 h 00 min |

Los resultados revelan cómo la función `Time` puede mostrar valores basados en el formato suministrado en la expresión de la función.

## Ejemplo: fundamentos de tiempo utilizando una opción diferente de TimeFormat

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Time.htm)

#### Expresión de gráfico

Vista general

Abra el Editor de carga de datos y añada el script de carga inferior en una nueva sección.

El script de carga contiene:

* Un conjunto de datos que se carga en una tabla de datos denominada `Example`.

* El siguiente campo en una tabla de datos:

  * `TimeValue`

* La variable `TimeFormat`, que utiliza el formato `hh.mm.ss`.

Script de carga

```
SET TimeFormat='hh.mm.ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];
```

Resultados

Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:

* ` TimeValue
                                       `

Cree las siguientes medidas:

* `=Time(TimeValue )`, para ver el valor como una hora con el formato utilizado en la configuración del sistema.

* `=Time(TimeValue, 'hh-mm' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm:ss' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm TT' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh:mm' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh.mm.ss' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh TT' )`, para ver el valor como una hora con el formato proporcionado en la función.

* `=Time(TimeValue, 'hh "Hrs" mm "Mins"' )`, para ver el valor como una hora con el formato proporcionado en la función.

Tabla de resultados

| TimeValue | Time(TimeValue) | Time(TimeValue, 'hh-mm') | Time(TimeValue, 'hh:mm:ss') | Time(TimeValue, 'hh:mm TT') | Time(TimeValue, 'hh:mm') | Time(TimeValue, 'hh.mm.ss') | Time(TimeValue, 'hh TT') | Time(TimeValue, 'hh "Hrs" mm "Mins"') |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 0.375 | 09.00.00 | 09-00 | 09:00:00 | 09:00 a. m. | 09:00 | 09:00:00 | 09 AM | 09 h 00 min |
| 0,99999 | 23:59:59 | 23-59 | 23:59:59 | 11:59 p. m. | 23:59 | 23.59.59 | 23:00 | 23 h 59 min |
| 35 648,375 | 09:00:00 | 09:00 | 09:00:00 | 09:00 AM | 09:00 | 09.00.00 | 09 AM | 09 h 00 min |

Los resultados revelan cómo la función `Time` puede mostrar valores basados en el formato suministrado en la expresión de la función.