다음을 통해 공유

DateTimeZone.From

통사론

DateTimeZone.From(value as any, optional culture as nullable text) as nullable datetimezone

소개

지정된 값에서 a datetimezone 를 만듭니다.

  • value: 를 만드는 데 사용되는 값입니다 datetimezone.
  • culture: (선택 사항) 값을 변환할 때 사용할 문화권입니다(예: "en-US").

다음 형식의 값을 datetimezone 값으로 변환할 수 있습니다.

  • text: 텍스트 표현에서 datetimezone 값을 반환합니다. 자세한 내용은 DateTimeZone.FromText 참조하세요.
  • date: datetimezone를 반환하며, 날짜 구성 요소로 value, 시간 구성 요소로 12:00:00 AM를 사용하고, 현지 표준 시간대에 해당하는 오프셋을 함께 반환합니다.
  • datetime: datetimezone을 날짜/시간과 현지 표준 시간대에 해당하는 오프셋으로 value와 함께 반환합니다.
  • datetimezone: 를 반환합니다 value.
  • time: 날짜 구성 요소로 OLE 자동화 날짜 datetimezone 에 해당하는 날짜와 시간 구성 요소 0 및 현지 표준 시간대에 해당하는 오프셋을 반환 value 합니다. OLE 자동화 날짜는 정수 구성 요소가 1899년 12월 30일 자정 이전 또는 이후의 일 수이며 소수점 구성 요소가 해당 날짜의 시간을 24로 나눈 부동 소수점 숫자로 구성됩니다. 예를 들어 자정, 1899년 12월 31일은 1.0으로 표시됩니다. 1900년 1월 1일 오전 6시, 2.25; 1899년 12월 29일 자정은 -1.0으로 표시됩니다. 1899년 12월 29일 오전 6시, -1.25로 표시됩니다. 기본값은 1899년 12월 30일 자정입니다. 최소값은 0100년 1월 1일 자정입니다. 최대값은 9999년 12월 31일의 마지막 순간입니다.
  • number: datetimezone로 표현된 OLE 자동화 날짜에 해당하는 날짜/시간과 해당 현지 표준 시간대 오프셋을 포함한 value을(를) 반환합니다.
  • null: 를 반환합니다 null.

value 다른 형식이면 오류가 반환됩니다.

로컬 표준 시간대에 해당하는 오프셋 값은 이 함수를 온라인으로 실행하는 것과 달리 로컬로 실행할 때 다릅니다. 로컬로 실행하면 현지 표준 시간대가 반환됩니다. 온라인으로 실행하면 UTC 표준 시간대(+00:00)가 반환됩니다.

예제 1

날짜, 시간 및 표준 시간대의 텍스트 표현을 값으로 datetimezone 변환합니다.

사용량

DateTimeZone.From("2020-10-30T01:30:00-08:00")

출력

#datetimezone(2020, 10, 30, 01, 30, 00, -8, 00)

예제 2

브라질 포르투갈어 날짜, 시간 및 표준 시간대의 텍스트 표현을 값으로 datetimezone 변환합니다.

사용량

DateTimeZone.From("13 de agosto de 2025 15:43:00 -03:00", "pt-BR")

출력

#datetimezone(2025, 08, 13, 15, 43, 00, -3, 00)

예제 3

2025년 1월 1일 오후 12시에 나타내는 숫자를 값으로 datetimezone 변환합니다. 결과의 표준 시간대는 예제가 로컬로 실행되는지 아니면 온라인으로 실행되는지에 따라 달라집니다.

사용량

DateTimeZone.From(45658.5)

출력

#datetimezone(2025, 01, 01, 12, 00, 00, 0, 00)

관련 콘텐츠

  • Last updated on