---
title: roSystemTime
slug: develop/es/rosystemtime
docTags: 
createdAt: 2025-03-11T07:07:17.200Z
---

Este objeto proporciona la capacidad de leer y escribir la hora almacenada en el reloj en tiempo real (RTC). También se puede utilizar para leer y escribir la configuración de la zona horaria. El equivalente en JavaScript es [systemtime](docId\:hkYT9deOESYc64h6ti2N3).

:::hint{type="info"}
Se admiten fechas hasta el 1 de enero de 2038.
:::

## ifUserData

### SetUserData(user\_data As Object)

Establece los datos del usuario que se devolverán cuando se activen eventos.

### GetUserData() As Object

Devuelve los datos del usuario que se establecieron previamente mediante `SetUserData()`. Devolverá `Inválido` si no se han establecido datos.

## ifMessagePort

### SetPort(port As roMessagePort)

Publica mensajes del tipo *roNetworkTimeEvent* en el puerto de mensajes adjunto.

## ifSystemTime

### GetLocalDateTime() As roDateTime

Devuelve la hora actual del RTC (modulada utilizando la zona horaria actual) como una instancia de *roDateTime*.

### GetUtcDateTime() As roDateTime

Devuelve la hora actual del RTC (modulada utilizando la zona horaria UTC/GMT) como una instancia de *roDateTime*.

### GetZoneDateTime(timezone\_name As String) As Object

Devuelve la hora actual del RTC (modulada utilizando la zona horaria especificada) como una instancia de *roDateTime* . Las zonas horarias admitidas se enumeran a continuación.

### SetLocalDateTime(local\_DateTime As roDateTime) As Boolean

Especifica una nueva hora para el RTC utilizando la zona horaria actual.

### SetUtcDateTime(utc\_DateTime As roDateTime) As Boolean

Especifica una nueva hora para el RTC utilizando la zona horaria UTC/GMT.

### GetTimeZone() As String

Devuelve la configuración actual de la zona horaria del reproductor. Se agrega un valor `POSIX:`: al comienzo de la cadena si la zona horaria se ha configurado utilizando el formato POSIX.

### SetTimeZone(zone\_name As String) As Boolean

Especifica una nueva configuración de zona horaria para el reproductor (las zonas horarias admitidas se enumeran a continuación). Alternativamente, se puede aplicar una zona horaria en formato POSIX agregando un valor `POSIX:` al comienzo de la cadena.

El siguiente código especifica una zona horaria con formato POSIX:

```text
t = CreateObject("roSystemTime")
t.SetTimeZone("POSIX:GMT-0BST-1,M3.5.0/1:00,M10.5.0/2:00")
```

### IsValid() As Boolean

Devuelve `Verdadero` si la hora del sistema está configurada con un valor válido. La hora se puede establecer desde el RTC o con NTP.

### GetLastNetworkTimeResult() As roAssociativeArray

Devuelve un arreglo asociativo que contiene información sobre el último intento de establecer la hora mediante la red:

- `success_timestamp`: Un valor que indica cuándo se configuró correctamente el reloj por última vez mediante la red. Este valor es cero si el reloj nunca se ha configurado correctamente mediante la red.
- `attempt_timestamp`: Un valor que indica cuándo se realizó el último intento de configurar el reloj mediante la red. Este valor es cero si aún no se ha realizado ningún intento.
- `failure_reason`: Si el último intento de configurar el reloj mediante la red falló, esta cadena contendrá un mensaje de error. Si el último intento fue exitoso, esta cadena estará vacía.

En este arreglo asociativo, "timestamp" se refiere al número de segundos desde que el reproductor se inició. Este valor se puede comparar con el tiempo total de actividad del reproductor, que se obtiene llamando a `UpTime(0)`.

## Zonas horarias admitidas 

Las siguientes son zonas horarias del sistema admitidas (esta lista no se aplica a las zonas horarias con formato POSIX):

- EST: hora del este de EE. UU.
- CST: hora central de EE. UU.
- MST: hora de montaña de EE. UU.
- PST: hora del Pacífico de EE. UU.
- AKST: hora de Alaska
- HST: hora de Hawái-Aleutianas sin horario de verano (Hawái)
- HST1: hora de Hawái-Aleutianas con horario de verano
- MST1: MT de EE. UU. sin horario de verano (Arizona)
- EST1: ET de EE. UU. sin horario de verano (este de Indiana)
- AST: hora del Atlántico
- CST2: México (Ciudad de México)
- MST2: México (Chihuahua)
- PST2: México (Tijuana)
- BRT: hora de Brasil (São Paulo)
- NST: hora de Terranova
- AZOT: hora de las Azores
- GMTBST: hora de Londres/Dublín
- WET: hora de Europa occidental
- CET: hora de Europa central
- EET: hora de Europa oriental
- MSK: hora de Moscú
- SAMT: zona horaria Delta (Samara)
- YEKT: zona horaria Echo (Ekaterimburgo)
- IST: hora estándar de la India
- NPT: hora de Nepal
- OMST: zona horaria Foxtrot (Omsk)
- JST: hora estándar de Japón
- CXT: hora de la Isla Christmas (Australia)
- AWST: hora del oeste de Australia
- AWST1: hora del oeste de Australia sin horario de verano
- ACST: hora estándar central de Australia (CST) con horario de verano
- ACST1: Darwin, Australia/Darwin y hora estándar central de Australia (CST) sin horario de verano
- AEST: hora del este de Australia con horario de verano
- AEST1: hora del este de Australia sin horario de verano (Brisbane)
- NFT: hora de Norfolk (isla) (Australia)
- NZST: hora de Nueva Zelanda (Auckland)
- CHAST: , hora de Fiyi, , Fiyi, Pacific/Fiji, zona horaria Yankee (Fiyi)
- SST: zona horaria X-ray (Pago Pago)
- GMT: tiempo medio de Greenwich
- GMT-1: 1 hora detrás del tiempo medio de Greenwich
- GMT-2: 2 horas detrás del tiempo medio de Greenwich
- GMT-3: 3 horas detrás de la hora del meridiano de Greenwich
- GMT-3:30: 3.5 horas detrás de la hora del meridiano de Greenwich
- GMT-4: 4 horas detrás de la hora del meridiano de Greenwich
- GMT-4:30: 4.5 horas detrás de la hora del meridiano de Greenwich
- GMT-5: 5 horas detrás de la hora del meridiano de Greenwich
- GMT-6: 6 horas detrás de la hora del meridiano de Greenwich
- GMT-7: 7 horas detrás de la hora del meridiano de Greenwich
- GMT-8: 8 horas detrás de la hora del meridiano de Greenwich
- GMT-9: 9 horas detrás de la hora del meridiano de Greenwich
- GMT-9:30: 9.5 horas detrás de la hora del meridiano de Greenwich
- GMT-10: 10 horas detrás de la hora del meridiano de Greenwich
- GMT-11: 11 horas detrás de la hora del meridiano de Greenwich
- GMT-12: 12 horas detrás de la hora del meridiano de Greenwich
- GMT-13: 13 horas detrás de la hora del meridiano de Greenwich
- GMT-14: 14 horas detrás de la hora del meridiano de Greenwich
- GMT+1: 1 hora por delante de la hora del meridiano de Greenwich
- GMT+2: 2 horas por delante de la hora del meridiano de Greenwich
- GMT+3: 3 horas por delante de la hora del meridiano de Greenwich
- GMT+3:30: 3.5 horas por delante de la hora del meridiano de Greenwich
- GMT+4: 4 horas por delante de la hora del meridiano de Greenwich
- GMT+4:30: 4.5 horas por delante de la hora del meridiano de Greenwich
- GMT+5: 5 horas por delante de la hora del meridiano de Greenwich
- GMT+5:30: 5.5 horas por delante de la hora del meridiano de Greenwich
- GMT+6: 6 horas por delante de la hora del meridiano de Greenwich
- GMT+6:30: 6.5 horas por delante de la hora del meridiano de Greenwich
- GMT+7: 7 horas por delante de la hora del meridiano de Greenwich
- GMT+7:30: 7.5 horas por delante de la hora del meridiano de Greenwich
- GMT+8: 8 horas por delante de la hora del meridiano de Greenwich
- GMT+8:30: 8.5 horas por delante de la hora del meridiano de Greenwich
- GMT+9: 9 horas por delante de la hora del meridiano de Greenwich
- GMT+9:30: 9.5 horas por delante de la hora del meridiano de Greenwich
- GMT+10: 10 horas por delante de la hora del meridiano de Greenwich
- GMT+10:30: 10.5 horas por delante de la hora del meridiano de Greenwich
- GMT+11: 11 horas por delante de la hora del meridiano de Greenwich
- GMT+11:30: 11.5 horas por delante de la hora del meridiano de Greenwich
- GMT+12: 12 horas por delante de la hora del meridiano de Greenwich
- GMT+12:30: 12.5 horas por delante de la hora del meridiano de Greenwich
- GMT+13: 13 horas por delante de la hora del meridiano de Greenwich
- GMT+14: 14 horas por delante de la hora del meridiano de Greenwich