SOAP API 開発者ガイド
jgetServerTimestamp()
API からシステムの現在のタイムスタンプ (協定世界時 (UTC)) を取得します。
構文
1GetServerTimestampResult timestamp = connection.getServerTimestamp();使用方法
API からシステムの現在のタイムスタンプを取得するには、getServerTimestamp() を使用します。たとえば、タイミングまたはデータ同期のために正確なタイムスタンプが必要な場合に実行します。オブジェクトに対して create() または update() を実行する場合、API はシステムのタイムスタンプを使用してオブジェクトの CreatedDate および LastModifiedDate 項目をそれぞれ更新します。
getServerTimestamp() コールはタイムスタンプを常に協定世界時 (UTC) で返します。ただし、ローカルシステムが、結果をシステムが属するタイムゾーンの設定に基づき自動的に表示してしまうことがあります。
サンプルコード — Java
このサンプルでは、サーバ時間を取得し、ユーザのローカルタイムゾーンでコンソールにそのサーバ時間を書き込みます。
1public void doGetServerTimestamp() {
2 try {
3 GetServerTimestampResult result = connection.getServerTimestamp();
4 Calendar serverTime = result.getTimestamp();
5 System.out.println("Server time is: "
6 + serverTime.getTime().toString());
7 } catch (ConnectionException ce) {
8 ce.printStackTrace();
9 }
10}サンプルコード — C#
このサンプルでは、サーバ時間を取得し、ユーザのローカルタイムゾーンでコンソールにそのサーバ時間を書き込みます。
1public void doGetServerTimestamp()
2{
3 try
4 {
5 GetServerTimestampResult result =
6 binding.getServerTimestamp();
7 DateTime serverTime = result.timestamp;
8 Console.WriteLine("Server time is: " +
9 serverTime.ToLocalTime().ToString());
10 }
11 catch (SoapException e)
12 {
13 Console.WriteLine("An unexpected error has occurred: " +
14 e.Message + "\n" + e.StackTrace);
15 }
16}引数
なし。