Zoho Flow での日付と時刻の値の操作

Zoho Flow での日付と時刻の値の操作

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

異なるアプリケーションでは、日付と時刻の値を異なる方法で扱います。アメリカ、ヨーロッパ、インターナショナルなど、さまざまな日付形式があり、アプリケーション間で日時の値を自動的に転送することは難しい課題です。一部のアプリケーションは他の日付形式を受け付けない場合があり、他のアプリケーションは値を誤解する可能性があります。例えば、アプリケーションが入力値として04-03-2020を受け取った場合、その設定によっては2020年3月4日または2020年4月3日と解釈することがあります。 

フローを構築する際には、日時の値が正確に変換されることを確認する必要があります。これにより、フロー内のエラーが最小限に抑えられ、正しい値が他のアプリに伝わります。この記事では、アプリが提供するさまざまな日付形式を特定し、変換して扱う方法について学びます。フロー内で日付形式を変換する前に、使用する基本的な表記法と形式を見てみましょう。

フローで日付形式を変換する前に、使用する基本的な表記法と形式を見てみましょう。

表記とフォーマット

基本的な表記

手紙

日付または時間の要素



年度

1996; 96

はい

週年

2009; 09


年の月

4月、4月、04


年の週数

18


月の中の週

3

d

月の日

10

D

年間の日

211


週の曜日名

月曜日;月

午前または午後のマーカー

午前または午後のマーカー

午後

時間

1日の時間(0-23)

2

h

午前/午後の時間(1-12)

3

k

1日の時間(1-24)

21

K

午前/午後の時間 (0-11)

10


時間の中の分

54


分の中で2番目

30


ミリ秒

853

X

ISO 8601 タイムゾーン

-08; -0800; -08:00


一般的な日付と時刻の形式

ISO 8601
ISO 8601
日時の値を表現するための標準化された方法であり、日時がアプリケーション間で伝達される最も一般的な形式です。

日付と時刻の形式:  yyyy-MM-ddThh:mm:ssXXX
例: 2018-11-26T11:54:39+05:30

日付形式: yyyy-MM-dd
例: 2018-11-26

UNIXタイムスタンプ  
1970年1月1日以降の経過秒数を表します(閏秒を除く)
例:1546491981

アメリカ人  
フォーマット: MM/dd/yyyy
例: 11/26/2018

ヨーロッパ  
フォーマット:dd/MM/yy
例:26/11/2018

国際  
フォーマット: yyyy-MM-dd
例:2018-11-26

重要なポイントに注意 

  1. UTC、GMTなどは時間の追跡方法です。実用上、UTCとGMTは同じです。
  2. ISO 8601、RFC 1123などは日時の形式です。ISO 8601はすべての現代アプリケーションで受け入れられている形式です。
  3. 文字Tは年月日部分と時分秒部分を区切るものです。アプリケーションで必要な日時の値から解析する必要があります。入力値から解析するには、シングルクォートを使用します。例えば、'yyyy-MM-dd'T'hh:mm:ss'という形式を出力形式として指定し、'yyyy-MM-ddThh:mm:ss'と指定しないようにしてください。
  4. ダブルクォート(' ')で囲まれた文字列から、任意の文字セットを解析するためにシングルクォート(' ')を使用してください。
  5. 日時の形式の末尾にある文字'Z'は、日時がUTCであることを意味します。つまり、UTCからのオフセットはゼロ時間です。
  6. もし'Z'の代わりに'+01:00'が表示されている場合、その瞬間のタイムゾーンがUTCより1時間進んでいることを示します。

フロー内の日付形式の特定

アプリがAPIを介してデータを送信する際には、常に特定の形式を使用します。アプリのAPIドキュメンテーションを参照して、使用されている日付の形式を特定できます。一部のアプリは、異なるエンティティに対して異なる形式を使用します。ドキュメンテーションの適切なセクションで日付の形式を参照するようにしてください。

日付形式を見つける別の方法は、フローに入力されるデータを確認することです。トリガーをテストすると、出力には日付の値が含まれます。
日付形式の特定

アクションを設定する際には、できるだけ受け入れられる日付形式を表示します。

Zoho CRMでディールが作成されると、Zoho Projectsでプロジェクトを作成するフローを考えてみましょう。新しいディールのデータを見ると、日付はyyyy-MM-dd形式で送信されています。
crm date format

Zoho Projectsでアクションを設定する際、MM-dd-yyyy形式のみ受け付けることがわかります。

この不整合のため、CRMからプロジェクトに直接日付の値をマッピングすることはできません。必要な作業内容がわかったので、日付の値を変換する方法を見てみましょう。

日付形式の変換

CRMからプロジェクトの形式に日付を変換するために、トリガーとアクションの間にカスタム関数を使用します。

カスタム関数を作成するために、このコードを使用してください:

  1. string dateformat(string dateStr, string inputFormat, string outputFormat)
  2. {
  3.   myDate = dateStr.toTime(inputFormat);
  4.   return myDate.tostring(outputFormat);
  5. }

この機能には、CRMトリガーからの日付、その形式、およびプロジェクトで受け入れられる形式の3つの入力が必要です。このカスタム関数は、実行中に1つの日付と時刻の値のみを変換することができます。

特定のケースで関数を使用する場合は、カスタム関数コードに日付形式も含めることもできます。

  1. string dateFormatCal(string dateStr)
  2. {
  3.   myDate = dateStr.toTime('yyyy-MM-dd HH:mm:ss');
  4.   return myDate.toString('MM-dd-yyyy');
  5. }

この機能は、任意の日付形式を標準形式のyyyy-MM-dd HH:mm:ssに変換し、指定された形式(この場合はMM-dd-yyyy)に変換します。この種の機能を使用する場合、出力日付形式ごとに異なる関数を記述する必要があります。

Zoho CRMとZoho Deskの間での日時形式の変換の別の例を見てみましょう。Zoho CRMの出力からの日時値が2021-07-20T10:33:00+05:30であり、それをZoho Deskの形式に変換したい場合、次のようになります:2021-07-20T10:33:00.000Z
 
これを行うには、以下の方法でカスタム関数を設定する必要があります:
 
  1. string dateFormat(string dateStr, string fromFormat, string toFormat)
  2. {
  3.     dateObj = dateStr.toTime(' yyyy-MM-dd'T'HH:mm:ss');
  4.     return dateObj.toString('yyyy-MM-dd'T'HH:mm:ss.SSS'Z'');
  5. }

日付や時間の値を加算または減算する

異なる国で作業する場合、異なるタイムゾーンでのフローが正常に機能することを確認する必要があります。カスタム関数を使用すると、日時の値を正確にタイムゾーン間で伝えることができます。

また、カスタム関数を使用して日時の加算や減算、リマインダーの設定も行うことができます。これを行う方法を理解するために、Googleカレンダーに予定されている会議の前日にZoho Cliqでチームに通知するフローを作成してみましょう。

イベントの前日を計算するために、このカスタム関数を使用します:

  1. string subDay(string dateStr)
  2. {
  3.   dateObj = dateStr.toDate('yyyy-MM-dd'T'HH:mm:ss');
  4.   resultDate = dateObj.subDay(1);
  5.   return resultDate.toString('yyyy-MM-dd');
  6. }

会議の日付は、このカスタム関数の入力です。この関数は、会議の前日の日付を計算します。

今度は、カスタム関数で指定された日付までフローを遅延させる処理を追加します。その後、フローはチームにリマインダーを送信します。

必要に応じて、これらの機能を変更したり、独自の機能を作成したりすることができます。使用できる関数については、Delugeヘルプページを参照してください。

日付と時刻の書式についてお話ししたい場合は、メールでお問い合わせください。メールアドレスはsupport@zohoflow.comです。


    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho WorkDrive Resources



                Zoho Desk Resources

                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day









                                • Related Articles

                                • WordPress用Zoho Flowプラグイン

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho Flow WordPressプラグインは、Gravity Forms、Elementor、Ninja Forms、LearnDashなどの30以上のWordPressプラグインを、使用する他の数百のアプリケーションと統合することを可能にします。 インストールの前提条件 ...
                                • Zoho OneからのZoho Flowへのアクセス

                                  Zoho Oneユーザーでありながら、Zoho Flowから試用期間の期限切れの通知が送信された場合、その理由は以下の通りです。 Zoho Flowには、Zoho Flowに登録して直接アクセスする方法と、既存のZoho Oneアカウントからアクセスする方法があります。 Zoho Flowアカウントに直接登録した場合(Zoho Oneアカウントを持っている場合でも)、そのアカウントで組織を作成すると、すぐに15日間の無料試用期間が始まります。この試用期間終了後は、無料プランに移行し、Zoho ...
                                • Zoho Flowにおける暗号化

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 ...
                                • Zoho Flowとのオンプレミスアプリ連携

                                  概要 自社のサーバーで運用しているアプリケーション(オンプレミスアプリケーション)がある場合、そのデータへのアクセスは規制されるため、一般的なクラウドアプリケーションからはアクセスできません。この場合、クラウドとオンプレミスアプリケーション間でデータを迅速かつ安全に移動するため、Zoho Flowに信頼性の高いゲートウェイが必要です。 Zoho Flowのオンプレミスエージェント オンプレミスエージェントとは、Zoho ...
                                • 複数のZohoアカウント接続をZoho Flowで作成する

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 いくつかの場合、組織では異なる部門や地域のために複数のZohoアカウントを使用することがあります。また、所有する複数のビジネスに対して異なるアカウントが存在する場合もあります。たとえば、同じZoho ...

                                Resources

                                Videos

                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                eBooks

                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                Webinars

                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                CRM Tips

                                Make the most of Zoho CRM with these useful tips.