La función #datetimezone crea un valor temporal de tipo datetimezone a partir de valores numéricos correspondientes al año, mes, día, hora, minuto, segundo y horas y minutos de diferencia con respecto a la hora UTC.
#datetimezone(
year as number,
month as number,
day as number,
hour as number,
minute as number,
second as number,
offsetHours as number,
offsetMinutes as number
) as any
- year: año
- month: mes
- day: día
- hour: hora
- minute: minuto
- second: segundo
- offsetHours: horas de diferencia con respecto a la hora GMT
- offsetMinutes: minutos de diferencia con respecto a la hora GMT
La función generará un error cuando no se cumplan estas condiciones:
- 1 ≤ year ≤ 9999
- 1 ≤ month ≤ 12
- 1 ≤ day ≤ 31
- 0 ≤ hour ≤ 23
- 0 ≤ minute ≤ 59
- 0 ≤ second ≤ 59
- -14 ≤ offset-hours + offset-minutes / 60 ≤ 14
También se generará un error cuando la fecha en cuestión no exista.
Podemos crear un valor temporal representando las 10:20:30 UTC+1 del día 4 de julio de 2020 con la siguiente expresión:
#datetimezone(2020,7,4,10,20,30,1,0)
04/07/2020 10:20:30 +01:00
Si la fecha no existe (como el 30 de febrero de 2020), la función devuelve un error:
#datetimezone(2020,2,30,10,20,30,1,0)
Error
