メインコンテンツへスキップ
見出し画像

XPression Visual Logicで「時間」を設計する:Date Timeブロック実務入門

    XPressionで現在時刻を表示したいとき、
    最初に思いつくのはClockブロックをTextにつなぐ方法だと思います。

    今の時刻をそのまま出すだけなら、それで十分な場面もあります。

    ただ、実際の現場では「現在時刻を表示する」だけで終わらないことが多いです。

    試合開始までの残り時間を出したい。
    イベント日を月・日・曜日に分けて表示したい。
    外部データから受け取った時刻を画面用の表記に整えたい。
    ある時刻を過ぎたら、表示内容を切り替えたい。
    現在時刻から1日前、30分後、1年前の日時を作りたい。

    こうなってくると、ClockをTextへつなぐだけでは足りません。

    XPressionのVisual Logicには、日付や時刻を扱うためのDate Time系ブロックがあります。

    Date/Time
    Offset
    Decode Date Time
    Encode Date Time
    Format Date Time
    Time Delta

    などです。
    さらに、曜日を扱うDay of the Weekや、Epoch形式の時刻を扱うConvert Epoch Timeも、時間設計では重要な役割を持ちます。

    この記事では、これらのブロックを単なる機能紹介ではなく、現場でどう考えて使うかという視点で整理します。


    第1章:XPressionで「時間」を扱うとは何か

    XPressionで時間を扱うとき、最初は「時計を表示する」ことだけを考えがちです。

    Clockブロックから現在時刻を取り、Textへ表示する。
    この流れは分かりやすく、シンプルです。

    ただ、実務で作るグラフィックスでは、時間は単なる表示要素ではありません。

    試合開始時刻、イベント開始日、カウントダウン、曜日表示、外部データから受け取る日時、一定時刻を過ぎた後の表示切替。
    こうしたものは、すべて「時間が変化すること」を前提に作る必要があります。

    XPressionのリアルタイムグラフィックスでは、完成した1枚の絵を作るだけではなく、現場で値が変わっても成立する仕組みを作ることが重要です。

    そのため、Date Time系ブロックは「時計表示のための機能」というより、時間を現場で扱える形に設計するための部品だと考えると理解しやすくなります。


    第2章:Date Timeは「文字」ではなく「変化する情報」として扱う

    Date Timeを理解するときに、まず大事なのはここです。

    日付や時刻は、ただの文字ではありません。

    たとえば、人間が見れば「2026/06/07 19:00」は日付と時刻に見えます。
    でも、Visual Logicの中では、それがDate Timeとして扱える値なのか、
    ただのStringなのかで意味が変わります。

    Stringとして扱えば、Textに表示することはできます。
    ただし、そのままでは時間差を計算したり、曜日を出したり、
    前後関係を判定したりするのが難しくなる場合があります。

    一方、Date Timeとして扱えれば、いろいろな処理ができます。

    現在時刻から1日前の日時を作る。
    年、月、日、時、分、秒に分解する。
    指定した年月日からDate Timeを作る。
    2つの時刻の差を計算する。
    曜日を出す。
    最後に見やすい文字列へ整える。

    つまり、XPressionで時間を扱うときは、
    最初から「Textに何を出すか」だけで考えない方が安全です。

    私が意識している基本は、次の流れです。

    計算や判定はDate Timeのまま行う。
    表示する直前にStringへ整える。

    この考え方を持っておくと、時間表示のテンプレートはかなり壊れにくくなります。

    画像

    第3章:Clockだけで済む場面、Date Timeブロックが必要な場面

    現在時刻をそのまま表示するだけなら、ClockからTextへつなぐ構成でも成立することがあります。

    ただし、現場で作るグラフィックスでは、もう一段深い要望が出てきます。

    時刻は出したいけれど秒は出したくない。
    日付だけを表示したい。
    月と日を別々のTextに出したい。
    曜日を自動で表示したい。
    試合開始までの残り時間を表示したい。
    指定時刻を過ぎたら表示を変えたい。
    外部データから受け取った時刻を、オンエアや会場表示に合う形へ整えたい。

    このような場合、Clockだけではなく、Date Time系ブロックを組み合わせて考える必要があります。

    初心者がつまずきやすいのは、Textに表示できた時点で完成だと思ってしまうことです。

    もちろん、表示できることは大事です。
    でも、実務ではそれだけでは足りません。

    本番前に修正できるか。
    日付が変わっても壊れないか。
    別の試合やイベントでも再利用できるか。
    オペレーターが扱いやすいか。
    外部データが変わったときに対応できるか。

    XPressionのテンプレートでは、見た目だけでなく、
    運用まで含めて設計する必要があります。

    時間表示は、その考え方が特に出やすい部分です。

    画像

    第4章:Date Time系ブロックの全体像

    画像

    Date Time系ブロックは、役割で分けて考えると理解しやすくなります。

    Date/Time Offsetは、日付や時刻を前後にずらすためのブロックです。
    現在時刻から1年前、1日後、30分前のような日時を作るときに使います。

    Decode Date Timeは、ひとつのDate Timeを、
    年、月、日、時、分、秒、ミリ秒に分解するためのブロックです。
    日付の一部だけを別々のTextに出したいときに使いやすいです。

    Encode Date Timeは、年、月、日、時、分、秒、ミリ秒から、
    ひとつのDate Timeを作るためのブロックです。
    試合開始時刻、イベント開始日、カウントダウンの目標時刻などを作るときに使います。

    Format Date Timeは、Date Timeを表示用の文字列に整えるためのブロックです。

    ClockやEncode Date Timeから来た値を、画面に出す形式へ整えます。

    Time Deltaは、2つのDate Timeの差を計算するためのブロックです。
    カウントダウンや、時刻の前後関係を扱いたいときに使います。

    Day of the Weekは、Date Timeから曜日を出すためのブロックです。
    月曜日をMonと出すのか、月と出すのか、といった表示文字を設定できます。

    Convert Epoch Timeは、Epoch形式の値をDate Timeへ変換するためのブロックです。外部データやシステム連携で時刻を受け取る場合に検討することがあります。

    こうして整理すると、Date Time系ブロックは「時計を表示するための機能」ではなく、時間を現場で扱いやすい形に加工するための部品だと分かります。

    第4.5章:ブロック画像で見るDate Time系ブロックの役割

    画像

    ここからは、Date Time系ブロックをもう少し具体的に見ていきます。

    Date Time系ブロックは、どれも日付や時刻を扱うためのブロックですが、役割はそれぞれ違います。

    見た目が似ているブロックもありますが、実務では「何を入力して、
    何を出力するのか」を理解しておくことが大切です。

    Clockから取得した現在時刻をそのまま表示するのか。
    指定した日時を作るのか。
    日付を分解するのか。
    表示用の文字列に整えるのか。
    2つの時刻の差分を出すのか。

    この違いを整理しておくと、Visual Logicで時間表示を組むときに迷いにくくなります。


    Convert Epoch Time:Epoch値をDate Timeに変換する

    画像

    Convert Epoch Timeは、
    Epoch形式の値をDate Timeへ変換するためのブロックです。

    外部システムやAPI、データベースなどから時刻を受け取る場合、日付文字列ではなくEpoch形式の数値で渡ってくることがあります。

    そのままでは人間が読める時刻として扱いにくいため、Convert Epoch TimeでDate Timeへ変換し、その後にFormat Date Timeなどで表示用に整える流れを考えます。

    入力はEpochです。
    出力はDate Timeです。

    この出力をFormat Date Timeへつなげば、表示用の文字列に整えられます。
    Time Deltaへつなげば、現在時刻との差分計算に使える可能性があります。

    ただし、Epochを扱うときは、外部データ側の仕様確認がとても重要です。

    Epoch値の単位は何か。
    UTCなのか、ローカル時間なのか。
    XPression側でReturn UTCをどう扱うべきか。
    変換後の時刻が、実際の予定時刻と一致しているか。

    見た目として日付が表示できていても、時刻がずれている場合があります。
    そのため、いきなり本番用のTextに入れるのではなく、まず検証用Textで元のEpoch値と変換後のDate Timeを確認するのが安全です。


    Date/Time Offset:日付や時刻を前後にずらす

    画像

    Date/Time Offsetは、入力されたDate Timeに対して、年、月、日、時、分、秒、ミリ秒の値を加えたり引いたりするブロックです。

    現在時刻から1日前。
    現在時刻から30分後。
    指定した日時から1年引いた日時。

    このように、基準になるDate Timeから前後にずらした日時を作りたいときに使います。

    入力には、基準になるDate Timeを入れます。
    Clockから現在時刻を入れることもできますし、Encode Date Timeで作った指定日時を入れることもできます。

    Yearは年単位のオフセットです。
    Monthは月単位のオフセットです。
    Dayは日単位のオフセットです。
    Hoursは時間単位、
    Minutesは分単位、
    Secondsは秒単位、
    Millisecondsはミリ秒単位のオフセットです。

    正の値を入れれば未来方向、負の値を入れれば過去方向へずらす考え方になります。

    出力は、Offset後のDate Timeです。

    実務では、Date/Time Offsetは便利な反面、月末、年末、うるう年のような日付では必ずテストした方が安全です。

    たとえば、1月31日から1か月後を作るような場合、期待通りの結果になるかは実際の環境で確認しておく必要があります。

    また、私はDate/Time Offsetの後ろにFormat Date Timeを置く構成をよく考えます。

    Date/Time Offsetは「日時をずらす」
    Format Date Timeは「表示形式を整える」

    このように役割を分けると、
    後からVisual Logicを見返したときに意図が分かりやすくなります。


    Decode Date Time:Date Timeを要素に分解する

    画像

    Decode Date Timeは、ひとつのDate Timeを、年、月、日、時、分、秒、ミリ秒に分解するブロックです。

    入力はDate Timeです。

    出力として、Year、Month、Day、Hours、Minutes、Seconds、Millisecondsを取り出せます。

    これは、日付や時刻の一部だけを別々のTextへ出したいときに便利です。

    月だけを大きく表示したい。
    日だけを別のTextに出したい。
    年を小さく配置したい。
    時と分を別々のレイヤーに入れたい。
    日付と曜日を別々に制御したい。

    このような場合、完成した日付文字列を1つのTextに入れるより、
    Decode Date Timeで要素を分けた方が再利用しやすくなります。

    ただし、Decode Date Timeで取り出した値をそのまま表示すれば、
    必ず見やすいとは限りません。

    たとえば、6月7日を表示する場合、6/7でよいのか、06/07にしたいのかで考え方が変わります。

    ゼロ埋めが必要な場合や、英語表記にしたい場合は、Format Date TimeやFormat Stringなどと組み合わせて整える必要があります。

    Decode Date Timeは「分解するブロック」であって、
    「最終表示を整えるブロック」ではないと考えると分かりやすいです。


    Encode Date Time:要素からDate Timeを組み立てる

    画像

    Encode Date Timeは、年、月、日、時、分、秒、ミリ秒から、
    ひとつのDate Timeを作るブロックです。

    Decode Date Timeが「分解」なら、Encode Date Timeは「組み立て」です。

    入力には、Year、Month、Day、Hours、Minutes、Seconds、Millisecondsがあります。

    たとえば、試合開始時刻、イベント開始日時、カウントダウンの目標時刻などを作るときに使います。

    Encode Date Timeの出力はDate Timeです。

    このDate TimeをTime Deltaへつなげば、現在時刻との差分を計算できます。
    Format Date Timeへつなげば、指定した日時を表示用の文字列に整えられます。

    実務で特に使いやすいのは、カウントダウンを作る場面です。

    Clockで現在時刻を取得する。
    Encode Date Timeで目標時刻を作る。
    Time Deltaで2つの時刻の差を計算する。
    差分をTextに表示する。

    この流れを作ることで、現在時刻に応じた残り時間表示ができます。

    ただし、
    Encode Date Timeは、入力値が正しくなければ出力も正しくなりません。

    外部データから値を受け取る場合は、年、月、日、時、分が別々に来るのか、ひとつの文字列で来るのか、Epoch形式で来るのかを事前に確認しておく必要があります。


    Format Date Time:Date Timeを表示用の文字列に整える

    画像

    Format Date Timeは、Date Timeを表示用のStringに変換するブロックです。

    入力はDate Timeです。
    出力はStringです。

    このStringをTextへ接続することで、画面上に表示できます。

    Format Date Timeには、Date Time Formatの設定があります。
    ここで、日付を出すのか、時刻だけを出すのか、秒まで出すのかなどを決めます。

    また、AM/PM表記を取り除きたい場合には、Strip AM/PMの設定を使うことがあります。

    Format Date Timeは、ClockやEncode Date Time、Convert Epoch Timeなどから来たDate Timeを、人間が読みやすい表記へ変換するために使います。

    現在時刻を出す
    日付だけを出す
    時刻だけを出す
    イベント日時を見やすく整える

    このような場面で使います。

    ここで大事なのは、
    Format Date Timeは単なる見た目の調整ではないということです。

    放送やアリーナ演出では、視聴者や観客が一瞬で読めることが大切です。

    12時間表記にするのか。
    24時間表記にするのか。
    秒まで出すのか。
    日付を日本式にするのか、英語式にするのか。
    AM/PMを出すのか。

    こうした表示ルールは、デザインだけでなく運用性にも関わります。


    Day of the Week:Date Timeから曜日を取り出す

    画像

    Day of the Weekは、Date Timeから曜日を取得するブロックです。

    入力はDate Timeです。
    出力はDayです。

    プロパティでは、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday、Sundayに対して、それぞれ表示する文字を設定できます。

    たとえば英語表記なら、Mon、Tue、Wedのように設定できます。
    日本語表記なら、月、火、水のようにする考え方もあります。

    曜日表示は小さな要素に見えるかもしれませんが、
    実務ではかなり重要です。

    イベント日程や試合日程を表示するとき、
    日付だけでなく曜日も出したい場面があります。

    このとき、曜日を手入力にしてしまうと、
    日付を変更したときに直し忘れる可能性があります。

    Day of the Weekを使えば、Date Timeから曜日を出せるため、
    日付変更時のミスを減らせます。

    曜日は装飾ではなく情報です。

    テンプレートとして再利用するなら、曜日はできるだけ手入力ではなく、Date Timeから自動で出す設計にしておく方が安全です。


    Time Delta:2つのDate Timeの差を計算する

    画像

    Time Deltaは、2つのDate Timeの差を計算するブロックです。

    カウントダウンや、指定時刻の前後判定を作るときに使います。

    Time Deltaには2つのDate Timeを入れて、その差や関係を扱います。

    出力には、Days、Hours、Minutes、Secondsがあります。
    これらを使うことで、2つのDate Timeの差分を表示できます。

    また、Equal、Greater、Less、Ordinalといった出力もあります。
    これらは2つのDate Timeの前後関係を扱うために使います。

    Time Deltaは、カウントダウン制作で特に使いやすいブロックです。

    Clockから現在時刻を取得する
    Encode Date Timeで目標時刻を作る
    Time Deltaで差分を計算する
    Days、Hours、Minutes、Secondsを使って残り時間を表示する

    この流れで、試合開始までの残り時間やイベント開始までのカウントダウンを作ることができます。

    ただし、Time Deltaで重要なのは、2つのDate Timeをどちらの入力に入れるかです。

    現在時刻と目標時刻の入れ方によって、Greater、Lessの読み方が変わる可能性があります。

    そのため、必ずテスト用Textを作って確認します。

    現在時刻
    目標時刻
    Days
    Hours
    Minutes
    Seconds
    Greater
    Less
    Equal

    これらを一度見える状態にして、意図した通りに動いているかを確認してから本番用の表示に組み込むと安全です。

    また、カウントダウンは0になったら終わりではありません。

    開始前
    開始時刻
    開始後

    この3つの状態をどう見せるかまで決めておく必要があります。


    Date Time系ブロックのまとめ

    Date Time系ブロックは、それぞれ役割がはっきりしています。

    • Convert Epoch Timeは、外部データのEpoch値をDate Timeへ変換する。

    • Date/Time Offsetは、Date Timeを前後にずらす。

    • Decode Date Timeは、Date Timeを年・月・日・時・分・秒に分解する。

    • Encode Date Timeは、年・月・日・時・分・秒からDate Timeを組み立てる。

    • Format Date Timeは、Date Timeを表示用のStringへ整える。

    • Day of the Weekは、Date Timeから曜日を取り出す。

    • Time Deltaは、2つのDate Timeの差分や前後関係を扱う。

    大切なのは、どのブロックも「Textに表示するためだけ」に使うのではなく、現場で変化する時間情報を壊れにくく扱うために使うということです。

    まずDate Timeとして正しい値を作る。
    必要に応じて、ずらす、分解する、組み立てる、差分を出す。
    最後にFormat Date TimeなどでStringへ整えてTextに渡す。

    この流れを意識すると、時間表示のテンプレートはかなり整理しやすくなります。

    画像

    第5章:Format Date Timeで表示形式を整える

    Format Date Timeは、Date Timeを表示用のStringに整えるブロックです。

    基本の考え方はシンプルです。

    Clockで現在時刻を取得する。
    Format Date Timeで表示形式を決める。
    String出力をTextへ渡す。

    この流れで、現在時刻を画面に表示できます。

    Format Date Timeには、Date Time Formatの設定があります。
    ここで、日付や時刻をどのような形で出すかを決めます。

    たとえば、日付と時刻を出すのか。
    時刻だけを出すのか。
    秒まで出すのか。
    月名を使うのか。
    年を表示するのか。

    実際に使える書式や表記は、使用しているXPressionの環境や設定で確認する必要があります。
    そのため、特定の書式がすべての環境で同じように使えるとは断定せず、
    最終的には自分の環境で確認するのが安全です。

    また、Format Date TimeにはAM/PM表示を取り除くための設定もあります。

    この設定は小さく見えますが、現場では重要です。

    アリーナビジョンや放送グラフィックスでは、観客や視聴者が一瞬で読めることが大切です。

    12時間表記にするのか、24時間表記にするのか。
    AM/PMを出すのか、出さないのか。
    秒まで出すのか、分まででよいのか。

    こうした判断は、デザインだけでなく、情報設計の問題です。

    Format Date Timeは、単に見た目を変えるブロックではありません。
    Date Timeを、視聴者やオペレーターが読みやすい情報へ整えるためのブロックです。


    第6章:Date/Time Offsetで日付や時刻を前後にずらす

    Date/Time Offsetは、入力されたDate Timeに対して、年、月、日、時、分、秒、ミリ秒の値を加えたり引いたりするブロックです。

    たとえば、現在時刻から1日前の日付を作る。
    現在時刻から30分後の時刻を作る。
    指定した日時から1年引いた日時を作る。

    こうした処理を行うときに使います。

    現場では、次のような場面で役立ちます。

    昨日の日付を自動で出したい。
    イベント開始時刻の30分前を基準にしたい。
    配信開始の一定時間前から告知表示を出したい。
    スポンサー掲出期間の前後を扱いたい。
    現在日時から一定期間後の日付を表示したい。

    Date/Time Offsetには、Year、Month、Day、Hours、Minutes、Seconds、Millisecondsの設定があります。
    正の値を使えば未来方向、負の値を使えば過去方向へずらす考え方になります。

    ただし、Date/Time Offsetを使うときには注意もあります。

    特に、月末や年またぎです。

    月をまたぐ日付計算や、2月を含む日付計算では、想定と違う結果に見えることがあります。

    これはXPressionに限らず、日付計算全般で注意が必要な部分です。

    本番で使う場合は、今日の日付だけで確認するのではなく、月末、年末、うるう年に関わる日付など、問題が出やすい条件でも確認しておくと安全です。

    また、Date/Time OffsetにもDate Time Formatの設定があります。
    ただ、私は役割を分けたい場合、Offsetの後ろにFormat Date Timeを置いて表示形式を整える構成をよく考えます。

    Date/Time Offsetは、日付や時刻をずらす。
    Format Date Timeは、表示形式を整える。

    このように役割を分けると、あとからVisual Logicを見返したときに分かりやすくなります。


    第7章:Decode Date Timeで日付や時刻を分解する

    Decode Date Timeは、ひとつのDate Timeを、年、月、日、時、分、秒、ミリ秒に分解するブロックです。

    たとえば、Clockから現在日時を入れると、Year、Month、Day、Hours、Minutes、Secondsのように個別の値を取り出せます。

    これは、デザイン上、日付や時刻の要素を分けて配置したいときに便利です。

    月だけを大きく表示したい
    日だけを別のTextに出したい
    年を小さく配置したい
    時と分を別々のレイヤーに入れたい
    日付と曜日を別々に制御したい

    After Effectsなどのプリレンダー制作に慣れていると、完成した1つの文字列として日付を作りたくなることがあります。

    しかし、XPressionでは、値が変わることを前提に考える必要があります。
    月、日、曜日、時刻などを必要に応じて分けておくと、テンプレートとして再利用しやすくなります。

    ただし、Decode Date Timeで取り出した値をそのまま表示すれば、必ず見やすいとは限りません。

    たとえば、6月7日を表示するときに、6/7でよいのか。
    06/07にしたいのか。
    Jun 7のような表記にしたいのか。
    曜日を英語にするのか、日本語にするのか。

    この判断は、見た目の好みだけではありません。
    会場表示やオンエアでは、読み間違いが起きにくい表記にすることが大切です。

    Decode Date Timeは、日付を分解するためのブロックです。
    最終的な見せ方は、Format Date TimeやFormat Stringなど、
    他の処理と組み合わせて考えると整理しやすくなります。


    第8章:Encode Date Timeで指定した日時を作る

    Encode Date Timeは、年、月、日、時、分、秒、ミリ秒から、
    ひとつのDate Timeを作るブロックです。

    Decode Date Timeが分解なら、Encode Date Timeは組み立てです。

    たとえば、
    Yearに2026
    Monthに6
    Dayに7
    Hoursに0
    Minutesに0
    Secondsに0
    を入れると、指定した日時をDate Timeとして作る考え方になります。

    このブロックが重要なのは、Time Deltaと組み合わせやすいことです。

    現在時刻はClockから取得する。
    目標時刻はEncode Date Timeで作る。
    その2つをTime Deltaへ入れる。
    差分を使ってカウントダウンを作る。

    この流れを理解すると、XPressionで時間を扱う幅がかなり広がります。

    Encode Date Timeを使うときに大事なのは、入力値をどこから持ってくるかです。

    固定値として設定するのか。
    Valueブロックなどで持たせるのか。
    外部データから受け取るのか。
    DataLinqと組み合わせるのか。

    ここを先に決めておかないと、後から修正しづらくなります。

    たとえば、毎回同じイベント日時なら固定値でも成立するかもしれません。
    でも、試合ごとに開始時刻が変わる場合は、手入力や外部データを前提にした設計が必要になることがあります。

    外部データから受け取る場合は、特に注意が必要です。

    年、月、日、時、分が別々に来るのか。
    ひとつの文字列として来るのか。
    Epoch形式の数値として来るのか。
    UTCなのか、ローカル時間なのか。

    これらによって、Visual Logicの組み方は変わります。

    Encode Date Timeは便利ですが、入力が正しくなければ出力も正しくなりません。本番前には、入力値と出力されたDate Timeを確認できるようにしておくと安心です。


    第9章:Time Deltaでカウントダウンと時刻判定を作る

    画像

    Time Deltaは、2つのDate Timeの差を計算するブロックです。

    Date Time系ブロックの中でも、特に現場で使いどころが多いブロックだと思います。

    たとえば、試合開始までの残り時間を出す場合です。

    現在時刻はClockから取得します。
    試合開始時刻はEncode Date Timeで作ります。
    その2つをTime Deltaに入れます。
    Time DeltaからDays、Hours、Minutes、Secondsなどを取り出します。
    必要に応じて表示用の文字列へ整えます。

    この流れで、カウントダウンの基本が作れます。

    Time Deltaは、単に残り時間を出すだけではありません。
    Equal、Greater、Less、Ordinalといった出力を使うことで、2つのDate Timeの関係を扱うこともできます。

    つまり、ある時刻より前か。
    同じ時刻か。
    過ぎているのか。

    こうした判断の材料にできます。

    ただし、Time Deltaは必ずテストした方がいいです。

    どちらのDate Timeをどちらに入れるのか。
    GreaterやLessをどう読むべきなのか。
    目標時刻を過ぎた後に値がどう変わるのか。

    ここは、初心者だけでなく、実務でもミスが起きやすい部分です。

    私なら、いきなり本番用のデザインに組み込まず、
    まず確認用のTextを作ります。

    現在時刻
    目標時刻
    Days
    Hours
    Minutes
    Seconds
    比較結果

    これらを一度画面に出して、意図した通りに動いているかを確認します。

    そして、カウントダウンで一番忘れてはいけないのが、目標時刻を過ぎた後の表示です。

    0になったら止めるのか
    非表示にするのか
    STARTや開催中に切り替えるのか
    次の演出へ移るのか
    そのままマイナス方向の値を出すのか

    ここを決めずに作ると、本番中に不自然な表示になることがあります。

    カウントダウンは、残り時間を出せば完成ではありません。
    開始前、開始時刻、開始後まで含めて設計することが大事です。


    第10章:Day of the Weekで曜日を手入力しない設計にする

    Day of the Weekは、Date Timeから曜日を取り出すためのブロックです。

    入力にDate Timeを入れると、その日付に対応した曜日を出すことができます。

    プロパティでは、Monday、Tuesday、Wednesday、Thursday、Friday、Saturday、Sundayに対して、それぞれ表示文字を設定できます。

    たとえば、英語表記ならMon、Tue、Wedのようにできます。
    日本語表記なら、月、火、水のようにする考え方もできます。

    曜日は小さな表示に見えますが、現場では意外と大切です。

    イベント告知で6/7とだけ出すより、6/7 SATのように曜日が入っていた方が伝わりやすいことがあります。試合日程やイベントスケジュールでも、曜日があるだけで情報の受け取りやすさが変わります。

    また、曜日を手入力にしていると、日付を変更したときに直し忘れることがあります。

    日付は変えたのに、曜日は前のまま。
    これはテンプレート運用で起きやすいミスです。

    テンプレートとして再利用するなら、
    曜日はできるだけDate Timeから出す設計にしておく方が安全です。

    現在の日付の曜日を出すなら、
    ClockからDay of the Weekへつなぐ考え方があります。
    特定の日付の曜日を出したいなら、Encode Date Timeで日付を作り、
    それをDay of the Weekへ入れる考え方があります。

    曜日は装飾ではなく、情報です。
    だからこそ、手入力ではなく仕組みとして扱えると、
    運用時のミスを減らせます。


    第11章:Convert Epoch Timeで外部データの時刻を扱う

    Convert Epoch Timeは、Epoch形式の値をDate Timeへ変換するためのブロックです。

    外部システムやAPI、データ連携では、時刻が人間に読みやすい文字列ではなく、Epoch形式の数値として渡ってくることがあります。

    その場合、Convert Epoch TimeでDate Timeへ変換し、
    必要に応じてFormat Date Timeで表示用に整える流れを考えます。

    Convert Epoch Timeには、Date Time Formatの設定があります。
    また、Return UTCに関わる設定もあります。

    ここで一番大事なのは、外部データの仕様を確認することです。

    受け取っている値は本当にEpochなのか。
    単位はどう扱われているのか。
    UTCなのか、ローカル時間なのか。
    XPression側でReturn UTCをどう設定するべきなのか。

    これらは、連携先やプロジェクトによって変わる可能性があります。
    そのため、不明なまま断定して進めるのは危険です。

    特に日本時間で運用する場合、UTCとの違いには注意が必要です。
    表示が数時間ずれる、日付が1日変わる、といった問題は、デザインではなく時刻データの扱いから起きることがあります。

    Epochを扱うときは、完成デザインに組み込む前に、検証用のTextを用意して確認するのがおすすめです。

    元データの値
    変換後のDate Time
    Format Date Timeを通した表示
    UTC設定を変えた場合の違い

    このあたりを一度見える状態にしてから、
    本番テンプレートへ入れた方が安全です。

    外部データ由来の時刻は、
    表示できたかどうかだけで判断しない方がいいです。
    正しい時刻として扱えているかまで確認する必要があります。


    第12章:DataLinqと組み合わせるときは「表示用」か「計算用」かを先に決める

    画像

    DataLinqなどで外部データを受け取る場合、Date Time設計で最初に考えるべきことがあります。

    それは、その時刻データを何に使うのかです。

    ただTextに表示するだけなのか。
    Time Deltaで残り時間を出したいのか。
    曜日を出したいのか。
    時刻を過ぎたら表示を切り替えたいのか。
    日付を分解して別々のTextに出したいのか。

    表示するだけなら、文字列のまま扱っても成立する場面があります。

    しかし、計算や判定に使いたいなら、Date Timeとして扱える形にする必要があります。

    ここを決めないまま作り始めると、後から構造を作り直すことになりやすいです。

    たとえば、試合開始時刻が外部データから来る場合を考えます。

    年、月、日、時、分が別々に来るなら、Encode Date Timeへ入れる構成が考えやすいかもしれません。
    すでに表示用の文字列として来るなら、そのままTextに出すことはできても、Time Deltaには向かない可能性があります。
    Epoch形式で来るなら、Convert Epoch Timeを検討することになります。

    どれが正解かは、データの仕様と、テンプレートでやりたいことによって変わります。

    大切なのは、外部データを受け取った時点で、表示用なのか、計算用なのかを分けて考えることです。


    第13章:Date Time設計でよくある失敗

    画像

    Date Time系ブロックは便利ですが、考え方を間違えると運用で崩れやすくなります。

    よくある失敗のひとつは、最初からすべてをStringで作ってしまうことです。

    見た目だけなら早く作れます。
    でも、あとからカウントダウンを追加したい、曜日を自動で出したい、時刻判定をしたいとなると、作り直しが必要になることがあります。

    次に多いのは、Time Deltaの向きを確認しないことです。

    現在時刻と目標時刻の入れ方を間違えると、GreaterやLessの読み方を逆にしてしまう可能性があります。
    必ずテスト用Textで確認した方が安全です。

    また、カウントダウンで目標時刻を過ぎた後の表示を決めていないケースもあります。

    開始前はきれいに動いていたのに、開始後に表示が崩れる。
    0を過ぎても想定外の値が出る。
    表示を切り替える条件が曖昧になる。

    こうした問題は、本番中に目立ちます。

    さらに、曜日を手入力してしまう失敗もあります。

    日付だけ差し替えて、曜日を直し忘れる。
    イベント日程が変更になったのに曜日が前のまま。
    これは現場で起きやすいミスです。

    最後に、外部データの時刻をそのまま信じてしまうことです。

    UTCなのか、ローカル時間なのか。
    Epochなのか、単なる数値なのか。
    表示用文字列なのか、計算可能な値なのか。

    ここを確認しないと、見た目は出ているのに正しくない、という状態になります。

    Date Timeで怖いのは、エラーとして分かりやすく壊れることだけではありません。一見正しく表示されているように見えて、実は時刻がずれていることです。

    だからこそ、確認が重要です。


    第14章:実務で破綻しにくくするための確認ポイント

    画像

    Date Timeを使うテンプレートを作るとき、私は次の順番で考えるようにしています。

    まず、基準になる時刻を決めます。

    現在時刻を使うのか
    指定日時を使うのか
    外部データから受け取るのか

    現在時刻ならClockが基準になります。
    指定日時ならEncode Date Timeを使うことがあります。
    外部データなら、値の形式を確認する必要があります。

    次に、その値を何に使うのかを決めます。

    表示するだけなのか
    計算するのか
    比較するのか
    分解するのか
    曜日を出すのか

    表示だけなら、Format Date Timeで整える流れが中心になります。
    計算や比較をするなら、Date Timeのまま扱うことを考えます。

    その次に、表示形式を決めます。

    秒は必要か
    日付は必要か。
    曜日は必要か
    AM/PMは必要か
    24時間表記にするのか
    ゼロ埋めは必要か
    日本語表記にするのか、英語表記にするのか

    そして最後に、本番運用を想定してテストします。

    現在時刻で正しく動くか
    指定時刻前は正しいか
    指定時刻ちょうどは正しいか
    指定時刻を過ぎた後はどうなるか
    日付を変更しても曜日が合っているか
    外部データが変わっても崩れないか
    月末や年またぎでも問題がないか

    この確認をしておくと、当日の不安がかなり減ります。


    第15章:ブロックを増やしすぎないことも設計の一部

    Date Time系ブロックは便利ですが、使いすぎるとVisual Logicが読みにくくなります。

    Offset、Decode、Encode、Format、Time Deltaを一つの流れに詰め込みすぎると、あとから見たときに何をしているのか分かりづらくなります。

    現場では、作った本人だけが触るとは限りません。
    別の人が修正することもあります。
    本番直前に値を変えることもあります。
    急な変更に対応することもあります。

    そのため、Visual Logicは見た目だけでなく、構造の読みやすさも大事です。

    私は、Date Timeを扱うときには、できるだけ役割を分けて考えます。

    日付を作る場所
    日付をずらす場所
    差分を計算する場所
    曜日を出す場所
    表示形式を整える場所
    Textへ渡す場所

    この流れが見えるようにしておくと、後から修正しやすくなります。

    また、Descriptionを入れられるブロックには、何のためのブロックかを書いておくと助かります。

    「試合開始時刻」
    「現在時刻から30分前」
    「表示用時刻」
    「イベント日付」
    「曜日表示」
    「カウントダウン差分」

    こうした説明があるだけで、Visual Logicの読みやすさはかなり変わります。

    リアルタイムグラフィックスでは、壊れにくさは見た目では分かりません。
    でも、本番運用ではそこが一番効いてきます。


    第16章:現場での判断基準

    Date Time系ブロックを使うときは、次のように判断すると整理しやすいです。

    現在時刻を表示したいなら、ClockとFormat Date Timeを考える。

    現在時刻や指定時刻を前後にずらしたいなら、Date/Time Offsetを考える。

    日付や時刻を年、月、日、時、分、秒に分けたいなら、Decode Date Timeを考える。

    特定の日時を作りたいなら、Encode Date Timeを考える。

    カウントダウンや前後関係を扱いたいなら、Time Deltaを考える。

    曜日を自動で出したいなら、Day of the Weekを考える。

    外部データのEpoch値を扱うなら、Convert Epoch Timeを考える。

    そして、どのブロックを使う場合でも、最後に確認することは同じです。

    その値はDate Timeとして扱うべきなのか
    それとも表示用のStringでよいのか
    表示形式は現場で読みやすいか
    変更が入っても直しやすいか
    本番中に値が変わっても壊れないか

    この判断基準を持っておくと、単なるブロックの使い方ではなく、
    テンプレート全体の設計として考えられるようになります。


    第17章:まとめ|時間は「素材」ではなく「仕組み」として扱う

    画像

    XPressionのDate Time系ブロックは、単に時計を表示するためのものではありません。

    日付をずらす。
    日付を分解する。
    日付を組み立てる。
    表示形式を整える。
    2つの時刻の差を計算する。
    曜日を出す。
    外部データの時刻を扱う。

    こうした処理を組み合わせることで、現場で使える時間表示を作ることができます。

    大切なのは、Textに何を出すかだけで考えないことです。

    日付や時刻は、常に変化する情報です。
    だからこそ、Date Timeとして扱う部分と、表示用のStringとして扱う部分を分けて考える必要があります。

    計算はDate Timeで行う。
    表示はFormat Date Timeなどで整える。
    外部データは、表示用なのか計算用なのかを最初に判断する。
    カウントダウンは、目標時刻を過ぎた後まで決めておく。
    本番前には、テスト用Textで値を確認する。

    この考え方を持っておくだけで、XPressionの時間表示はかなり安定します。

    XPressionは、完成した1枚の映像を作るだけのツールではありません。
    現場で変化する情報を、読みやすく、壊れにくく、再利用しやすい形で動かすための設計ツールです。

    Date Timeブロックは、その考え方を学ぶうえで、とても良い入口だと思います。

     
     
    XPressionを中心に、放送・アリーナ・スコアボード向けリアルタイムグラフィックスのTipsやHow-toを発信します。

    あなたへのおすすめ