Funciones de fecha y hora en Jitterbit Integration Studio
Introducción
Si está utilizando estas funciones junto con el Now
o Now_
funciones, tenga en cuenta que la huso horario devuelta es la configurada en la máquina que ejecuta el agente. Todos los agentes de la nube están en UTC. Los agentes privados variarán según la máquina específica en la que se ejecuta cada agente. Si está utilizando una función de conversión, tenga esto en cuenta si su proyecto está diseñado para ejecutarse tanto en la nube como en un agente privado.
Nota
Si tiene la configuración Anular Huso horario del Agente de programación habilitada en las políticas de su organización, cualquier secuencias de comandos que utilice funciones de fecha y hora como las descritas aquí no será reemplazado por la huso horario seleccionada.
Códigos de zona horaria
Los parámetros de huso horario son uno de los códigos de huso horario estándar, ya sea un nombre completo (código TZ) como "America/Los_Angeles"
, un desfase UTC como "UTC-8:00"
, o una abreviatura como "PST" (código de tres letras). Los códigos de zona horaria distinguen entre mayúsculas y minúsculas. Se recomienda utilizar códigos TZ con el nombre completo si se utiliza una huso horario, ya que "AST" puede hacer referencia a la hora estándar del "Atlántico" o "árabe".
- Los códigos TZ (una lista no oficial) se pueden encontrar en https://en.wikipedia.org/wiki/List_of_tz_database_time_zones.
- Los códigos de tres letras se enumeran en https://en.wikipedia.org/wiki/List_of_time_zone_abbreviations. La IANA ha dejado de utilizarlas, aunque actualmente se admiten.
- Puede encontrar información adicional en https://www.iana.org/time-zones.
Convertir horas Unix a fechas
Si una hora Unix es un número que incluye una precisión de milisegundos, puede utilizar un código similar a este para convertir una hora Unix en una fecha:
// If you have a Unix timestamp with milliseconds such as
createdate = "1478119530707";
// You can convert it to a date by
// truncating the last three digits and using FormatDate:
date = double(Left(createdate, 10));
FormatDate(date, "yyyy-mm-dd");
ConvertTimeZone
Declaración
string ConvertTimeZone(date d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])
string ConvertTimeZone(string d, string fromTZ, string toTZ[, bool is_european_format, bool ignoreDST])
Sintaxis
ConvertTimeZone(<d>, <fromTZ>, <toTZ>[, <is_european_format>, <ignoreDST>])
Parámetros necesarios
date
: Una fecha, ya sea como un objeto de fecha o como una cadena de fechafromTZ
: La huso horario desde la que se convertirá, expresada como un código de huso horariotoTZ
: La huso horario a la que se convertirá, expresada como un código de huso horario
Parámetros opcionales
-
is_european_format
: Esta bandera opcional determina si se utilizará el formato de fecha europeo. Cuandotrue
, el formato es día y luego mes; cuandofalse
El formato es mes y luego día. -
ignoreDST
: De manera predeterminada, el horario de verano se tiene en cuenta al realizar la conversión entre las cuatro husos horarios principales de EE. UU. Establezca esta bandera opcional entrue
para anular esta acción.
Descripción
Toma una fecha y la devuelve convertida de una huso horario a otra.
Nota
Si está utilizando ConvertTimeZone
en conjunto con Now
o Now_
Tenga en cuenta que la huso horario devuelta es la configurada en la máquina en la que se ejecuta el agente. Todos los agentes de la nube están en UTC. Los agentes privados variarán según la máquina específica en la que se ejecute cada agente. Si está utilizando una función de conversión, como ConvertTimeZone
Tenga esto en cuenta si su proyecto está diseñado para ejecutarse tanto en la nube como en un agente privado.
Ejemplos
ConvertTimeZone(Now(), "UTC", "America/Los_Angeles", false, false);
// If Now() is 2017-03-10 18:34:37
// returns "2017-03-10 10:34:37"
ConvertTimeZone("02/06/2017 5:25:00", "America/Los_Angeles", "America/New_York");
// returns "2017-02-06 08:25:00" (shifts the time by 3 hours)