日付トークン機能

メッセージに「本日の日付」「本日から起算してX日後の日付」「HubSpotの日時プロパティの値」をカスタムトークンで動的に挿入する機能

更新日:2025/8/25

この機能を用いるメリット

  • カスタマイズされた日付を自動で挿入できます
  • 柔軟な日付フォーマットに対応し、様々な表示形式を選択できます
  • 相対日付計算により、今日から指定日数後の日付を自動計算します
  • HubSpotの日時プロパティの値を指定したフォーマットで送信できます
  • 送信するたびにカスタマイズされた最新の日付情報が反映されます

本機能を利用する場合、以下の注意点がございます。

  • 日付はカスタマイズされたタイミングで計算されます
  • 時刻情報を表示する場合は、時刻データが含まれる日付変数が必要です

使用可能なトークンとデータの流れ

  1. 本日の日付を挿入:{{todayDate}}
    • 基本構文:{{todayDate "フォーマット"}}
    • 使用例:
       
      今日は{{todayDate "YYYY年M月D日"}}です
      本日{{todayDate "M/D"}}より開始いたします
      {{todayDate "M月D日(ddd)"}}に実施予定
  2. 指定日数後の日付を挿入:{{addDays}}
    • 基本構文:{{addDays 日数 "フォーマット"}}
    • 使用例: 
      {{addDays 7 "M/D"}}に結果発表
      申請期限は{{addDays 14 "YYYY年M月D日"}}までです
      {{addDays 3 "M月D日(ddd)"}}にご連絡いたします
  3. HubSpotの日時プロパティをフォーマット:{{formatDate}}
    • 基本構文:{{formatDate 日時プロパティの内部名 "フォーマット" "ロケール"}}
    • HubSpotの日時プロパティの内部名を指定することで、そのプロパティの値を指定したフォーマットで送信できます
    • 使用例:
      {{formatDate day_naibumei "M月D日(ddd) HH時mm分" "ja"}}
      {{formatDate interview_date "YYYY/MM/DD HH:mm" "ja"}}
      {{formatDate deadline "M月D日まで" "ja"}}

設定手順

1. 日付フォーマットの確認 以下のフォーマットがご利用いただけます。

フォーマット 表示例 説明
YYYY年M月D日 2024年8月25日 年月日(日本語)
M/D 8/25 月/日(シンプル)
MM/DD 08/25 月/日(ゼロパディング)
YYYY/MM/DD 2024/08/25 年/月/日
M月D日(ddd) 8月25日(月) 月日+曜日
M月D日(ddd) HH時mm分 8月25日(月) 14時30分 月日曜日+時刻
HH:mm 14:30 時刻のみ

2. メッセージでの使用例 必要な箇所にトークンを挿入してメッセージを作成してください。

実用的な使用例

🎉 本日{{todayDate "M月D日"}}より受付開始!
皆様は{{addDays 14 "M/D"}}に内定が狙えます😍

面接日程:{{formatDate interview_date "M月D日(ddd) HH時mm分" "ja"}}
当日は{{formatDate interview_date "HH時mm分" "ja"}}までにお越しください

応募締切:{{addDays 10 "YYYY年M月D日"}}まで

本日が2025/8/25、内部名interview_dateの日時のプロパティが2025/09/05 12:00 GMT+92025/08/25 08:00 GMT+9の場合は以下のようになります。

▼LITTLE HELP CONNECTの設定画面

スクリーンショット 2025-08-25 11.41.58

実際に表示されるメッセージ
スクリーンショット 2025-08-25 11.43.16

動作確認

  1. トークンの表示確認
    • メッセージのテスト配信を行い、トークンが正しい日付フォーマットで表示されることを確認してください
  2. 日付計算の確認
    • addDaysを使用した相対日付が正しく計算されているか確認してください
  3. フォーマットの確認
    • 指定したフォーマット通りに日付が表示されているか確認してください

トラブルシューティング

よくある問題

Q: 日付が正しく表示されない

A: フォーマット文字列を確認してください。大文字小文字の区別があります。

Q: 曜日が英語で表示される

A: formatDateでロケールに"ja"を指定してください。

Q: 時刻が表示されない

A: 使用している日時プロパティに時刻情報が含まれているか確認してください。時刻データがないプロパティでは時刻フォーマット(HH時mm分など)は使用できません。

 

参考:HubSpotの日時プロパティについて formatDateで使用する日時プロパティの内部名は、HubSpotで定義されたプロパティの内部名を使用する必要があります。利用可能な日時プロパティの内部名については、HubSpotのプロパティ設定画面でご確認いただけます。