Kashiwazaki SEO Dynamic Date

投稿や固定ページに動的な日付を表示するショートコードを提供し、コンテンツを常に最新の状態に保つことでSEO効果を向上させるWordPressプラグインです。

このドキュメント中の出力例は、2026年8月10日 に表示した場合の値です。日付・日付差は実行時に計算されるため、実際の表示は閲覧時点の値になります。

概要

このプラグインは、投稿や固定ページに動的な日付を簡単に挿入できる [ksdate] ショートコードを提供します。これにより、コンテンツの鮮度を保ち、検索エンジンに対して最新の情報であることをアピールできます。

主な機能

• 動的日付表示: 現在の日付を自動的に表示
• カスタムフォーマット: PHPのdate()関数と同じ形式でカスタマイズ可能
• 相対日付: 過去や未来の日付を相対的に指定可能（例：20年前、6ヶ月前など）
• 日付差分計算: 指定日からの経過時間、未来の日付までのカウントダウンを表示
  • 年単位: [ksdate diff="1999" unit="year"] → 27
  • 月単位: [ksdate diff="1999-01" unit="month"] → 331
  • 日単位: [ksdate diff="1999-01-01" unit="day"] → 10083
  • 数字だけを返すので、歳 ヶ月 日目 などの単位は投稿側で自由に書けます
• SEO最適化: コンテンツの鮮度維持により検索順位向上に貢献
• 軽量実装: 外部ライブラリ不要で高速動作

インストール

1. プラグインフォルダを /wp-content/plugins/ ディレクトリにアップロード
2. WordPressの「プラグイン」メニューからプラグインを有効化
3. 投稿や固定ページで [ksdate] ショートコードを使用

使い方

基本的な使用方法

[ksdate]                        // デフォルト: Y年m月d日形式
[ksdate format="Y年m月d日"]      // 日本語形式
[ksdate format="Y/m/d"]         // スラッシュ区切り
[ksdate format="Y-m-d H:i:s"]  // 日時を含む形式

相対日付の使用

[ksdate format="Y年" offset="-20y"]    // 20年前
[ksdate format="Y年m月" offset="-6m"]  // 6ヶ月前
[ksdate format="Y/m/d" offset="+3d"]   // 3日後
[ksdate format="Y/m/d" offset="-1w"]   // 1週間前

日付差分の使用

過去からの経過時間

[ksdate diff="1999" unit="year"]        // 出力: 27
[ksdate diff="1999" unit="month"]       // 出力: 331
[ksdate diff="1999" unit="day"]         // 出力: 10083
[ksdate diff="1999"]                    // 出力: 27年（unit 省略時は単位付き）

私は[ksdate diff="1979-09-17" unit="year"]歳です   // 出力: 私は46歳です
開店から[ksdate diff="2024-01-01" unit="day"]日目  // 出力: 開店から952日目

未来までのカウントダウン

[ksdate diff="2030" unit="year"]        // 出力: 4
[ksdate diff="2030" unit="day"]         // 出力: 1240
[ksdate diff="2026-12" unit="month"]    // 出力: 4

2030年まであと[ksdate diff="2030" unit="year"]年   // 出力: 2030年まであと4年

パラメータ

パラメータ	必須	デフォルト値	説明
format	任意	Y年m月d日	PHP date()関数の形式文字列。日付表示専用で、diff 使用時は影響しません
offset	任意	なし	相対的な日付オフセット
diff	任意	なし	差分計算の基準日
unit	任意	日付の精度に依存	差分を返す単位。year / month / day。指定すると数字だけを返します

オフセット形式

• 年: y (例: -20y, +5y)
• 月: m (例: -6m, +3m)
• 週: w (例: -1w, +2w)
• 日: d (例: -30d, +7d)

差分計算形式

unit を省略したときは、基準日の精度で単位が決まり、単位の文字が付いた状態で出力されます。

• YYYY形式 (例: "1999", "2030") → 年単位（例: 27年）
• YYYY-MM形式 (例: "1999-01", "2026-12") → 月単位（例: 331ヶ月）
• YYYY-MM-DD形式 (例: "1999-01-01", "2026-12-31") → 日単位（例: 10083日）

unit で明示すれば、基準日の精度に関係なく切り替えられます。

unit	返す値	別名
year	通算の年数	y / 年 / 歳
month	通算の月数	m / 月 / ヶ月 / ヵ月 / ケ月
day	通算の日数	d / 日

いずれも先頭からの通算値です（「46年10ヶ月24日」のような内訳ではありません）。

unit を指定した場合は数字だけを返します。 単位の文字が出力に含まれないため、歳 と書きたいか 年 と書きたいかを投稿側で決められます。unit を省略した場合は従来どおり単位付きで出力されるので、既存の記事はそのまま動きます。

過去と未来で丸め方が異なります

• 過去（経過時間）: 完了した単位を数えるため切り捨て。1年11ヶ月経過 → 1年
• 未来（残り時間）: 残っている期間を示すため切り上げ。あと0年4ヶ月 → 1年

未来を切り捨てると、まだ4ヶ月残っているのに「あと0年」と表示されてしまうためです。

使用例

SEOでの活用

<!-- 更新日を常に最新に -->
<p>最終更新: [ksdate format="Y年m月d日"]</p>

<!-- 過去の統計データの表示 -->
<p>[ksdate format="Y年" offset="-1y"]の売上データ</p>

<!-- イベント告知 -->
<p>[ksdate format="m月d日" offset="+7d"]開催予定</p>

<!-- 記事の鮮度アピール -->
<p>この情報は[ksdate format="Y年m月"]時点のものです。</p>

<!-- コピーライト表記 -->
<p>© [ksdate format="Y"] Your Company Name. All Rights Reserved.</p>

<!-- 創業からの年数 -->
<p>1999年から[ksdate diff="1999" unit="year"]年が経過しました</p>

<!-- 年齢表示 -->
<p>柏崎剛（[ksdate diff="1979-09-17" unit="year"]歳）</p>

<!-- カウントダウン（過ぎた日付を指定すると経過日数になるので注意） -->
<p>2030年まであと[ksdate diff="2030" unit="year"]年</p>

実用的な使用例

1. ニュース・レポート記事

   <div class="article-meta">
      <span>公開日: 2024年1月1日</span>
      <span>最終確認: [ksdate format="Y年m月d日"]</span>
   </div>

2. 統計情報の表示

   <h2>[ksdate format="Y年" offset="-1y"]から[ksdate format="Y年"]までの成長率</h2>
   <p>[ksdate format="Y年n月" offset="-3m"]以降のデータ分析</p>

3. イベント・キャンペーン

   <div class="campaign">
      <h3>期間限定キャンペーン</h3>
      <p>[ksdate format="n月j日"]から[ksdate format="n月j日" offset="+7d"]まで</p>
   </div>

フォーマット文字列の例

よく使用されるフォーマット：

• Y年m月d日 - 2026年08月10日
• Y/m/d - 2026/08/10
• Y-m-d - 2026-08-10
• Y年n月j日 - 2026年8月10日（ゼロパディングなし）
• Y年m月 - 2026年08月
• m月d日 - 08月10日
• Y - 2026（年のみ）
• F j, Y - 8月 10, 2026（英語形式）
• l, F j, Y - 月曜日, 8月 10, 2026（曜日付き英語形式）

技術仕様

要件

• WordPress 5.8以上
• PHP 7.4以上

セキュリティ

• すべての入力パラメータはサニタイズ処理
• XSS攻撃に対する保護（esc_html()使用）
• 直接アクセスからの保護

パフォーマンス

• 軽量な実装（外部ライブラリ不要）
• キャッシュプラグインとの互換性
• WordPressのタイムゾーン設定に準拠

管理画面

管理メニューから「Kashiwazaki SEO Dynamic Date」を選択すると、使用方法とサンプルコードを確認できます。

トラブルシューティング

日付が表示されない場合

• ショートコードの記述が正しいか確認してください
• プラグインが有効化されているか確認してください

不正な日付が表示される場合

• formatパラメータの形式が正しいか確認してください
• offsetパラメータの形式が正しいか確認してください（例：-20y, +3d）

タイムゾーンが異なる場合

• WordPressの設定 > 一般 > タイムゾーンを確認してください

ライセンス

GPL v2 or later

作者

柏崎剛 (Tsuyoshi Kashiwazaki)

• ウェブサイト: https://www.tsuyoshikashiwazaki.jp

サポート

ご質問やバグ報告は、作者のウェブサイトまでお問い合わせください。

更新履歴

変更内容は CHANGELOG.md を参照してください。

今後の拡張予定

• 曜日表示のサポート
• より多くの言語への対応
• ブロックエディタ（Gutenberg）対応
• カスタムキャッシュオプション
• より高度な日付計算機能