【ServiceNow】ServiceNowとJavaScriptの日付取得の違い

ServiceNow

2026.05.13 UP

こんにちは。ServiceNow担当のなちです。

ServiceNowで開発をしていると、日付や時刻を扱う場面は多くあります。
その中で「思った時間と違う値が入っている」「なぜか時間がずれる」と感じたことはありませんか？
実はこの原因の多くはJavaScriptの組み込みオブジェクト（以下、JS標準オブジェクト）と、ServiceNowが提供するプラットフォームオブジェクト（以下、SN独自オブジェクト）での日付の扱いの違いにあります。
本記事では、JS標準オブジェクトとSN独自オブジェクトの違いを整理し、タイムゾーンによるズレを防ぐためのポイントを解説します。

CONTENTS

タイムゾーンとは

タイムゾーンとは、ある地域で共通に使われる時刻のルールです。
日本であれば「日本標準時（JST）」が使われており、これはUTC（協定世界時）+9時間となっています。
システム開発において重要なのは、以下の2つの概念です。

UTC（協定世界時）：時刻データを扱うための世界共通の基準時刻
ローカルタイム：ユーザーのタイムゾーンに応じた表示上の時刻

多くのシステムでは、データの整合性を保つためにUTCで保存し、表示時にローカルタイムへ変換する仕組みが採用されています。
ServiceNowもまた、この考えに基づいています。

JavaScript組み込みの日付オブジェクト

JS標準オブジェクトでは、Dateオブジェクトを使用して日付を扱います。

（上記コードはブラウザなどのクライアント環境で実行した場合の書き方）

JS標準オブジェクトは、実行環境により、時間の扱いが異なります。
ブラウザ等のクライアントサイドであれば、使用しているPCの時間に準拠し、
サーバーで動いていれば、サーバーのタイムゾーンを参照します。
一方で、toISOString()などのメソッドを使用することで、UTC形式の値も取得可能です。

つまり、JS標準オブジェクトでは、
基本は実行環境に準拠した時間を扱う
という考え方になります。

ServiceNow独自APIの日付オブジェクト

ServiceNowでは、主に以下のオブジェクトを使用して日付を扱います。

GlideDateTime
GlideDate

例として、GlideDateTimeを見てみましょう。

ここで重要なのは、SN独自オブジェクトではデータはUTCで保持される、という点です。
GlideDateTime()：UTCの値を取得
getDisplayValue()：ユーザーのタイムゾーンに変換された値を取得

つまり、内部的には常にUTCで管理されており、表示時にユーザーごとの設定に応じて変換されます。
保存はUTC、表示でローカル変換
これがSN独自オブジェクトでの基本的な考え方です。

JS標準オブジェクトとSN独自オブジェクトの違い

ここまでの内容を整理すると、以下のようになります。

JS標準オブジェクトのnew Date()（クライアントサイド）：PC時間
JS標準オブジェクトのnew Date()（サーバーサイド）：サーバー時間
GlideDateTime()：UTCの値を取得
GlideDateTime().getDisplayValue()：ユーザーのタイムゾーンに変換された値を取得

今回はServiceNow内でそれぞれを扱うため、実行されるJS標準オブジェクトのnew Date()は、サーバー側の時間を扱います。

実験してみた

ここからは、SN独自オブジェクトとJS標準オブジェクトの日付取得方法の違いをより理解するため、簡単な検証を行います。

①基本検証

時間設定は以下の通りです。
ServiceNowサーバー時間：アメリカ/PDT（米国太平洋夏時間）（UTC-7）
ユーザー時間：日本（UTC＋９）
インスタンス時間：日本（UTC＋９）
パソコン時間：日本（UTC＋９）
UTC：協定世界時

※ServiceNowの環境ごとのサーバー時間は、アプリケーションメニューで「stats.do」を打ち込むと表示させることができます。
今回の実験に使用した環境では以下のようになっていました。

PDTと書かれているため、このDemo Serverのサーバー時間はPDT（米国太平洋夏時間）時間を取ってきているということが分かります。

実験時の時間は
アメリカ：2026/4/20 20:52
日本：2026/4/21 12:52
UTC：2026/4/21 3:52
以下のスクリプトをServiceNowのバックグランドスクリプトで実行します。

検証結果

JS標準オブジェクトのDate→アメリカ/PDT
GlideDateTime（getValue）→UTC
GlideDateTime（getDisplayValue）→日本
となっていることがわかります。

②ユーザーのタイムゾーン変更

次に、ユーザーのタイムゾーンを変更して実行してみます。
ユーザーアイコンのPreferencesから、Timezoneを「US/Hawaii」に設定します。

以下の設定で実行します。
・ServiceNowサーバー時間：アメリカ（PDT（UTC-7））
・ユーザー時間：US/Hawaii（UTCー10）
・インスタンス時間：日本（UTC＋９）
・パソコン時間：日本（UTC＋９）
・UTC：協定世界時

実験時の時間は
アメリカ：2026/4/20 20:59
日本：2026/4/21 12:59
UTC：2026/4/21 3:59
ハワイ：2026/4/20 17:59
です。

検証結果

・JS標準オブジェクトのDate→アメリカ/PDT＝サーバー時間
・GlideDateTime（getValue）→UTC
・GlideDateTime（getDisplayValue）→US/Hawaii＝ユーザー時間
となっていることがわかります。

よって、ユーザー時間を変更すると、SN独自オブジェクトのgetDisplayValue()で取れる値に影響することが分かります。

③ServiceNowインスタンス時間変更

また、ServiceNowのインスタンス自体の時間も変更して実行してみます。
アプリケーションメニューで「Basic Configuration UI16」と検索してページを開き、System timezone for all users unless overriden in the user’s recordと書かれた項目のプルダウンを変更します。

以下の設定で実行します。
・ServiceNowサーバー時間：アメリカ（PDT（UTC-7））
・ユーザー時間：日本（UTC＋９）
・インスタンス時間：Europe/Paris（UTC＋2）
・パソコン時間：日本（UTC＋９）
・UTC：協定世界時
（インスタンス時間を変更すると自動的にユーザー設定時間が変更されてしまうため、インスタンス時間変更後にユーザー時間をJSTに再設定しました。）

実験時の時間は
アメリカ：2026/4/20 21:16
日本：2026/4/21 13:16
UTC：2026/4/21 4:16
パリ：2026/4/21 8:16
です。

検証結果

・JS標準オブジェクトのDate→アメリカ/PDT＝サーバー時間
・GlideDateTime（getValue）→UTC
・GlideDateTime（getDisplayValue）→日本＝ユーザー時間
この場合、getDisplayValue()は、インスタンス時間に関係なく、ユーザー時間を取ってきていました。