holiday

祝日検索

概要

任意の日付の祝日情報を検索します。休みかどうか、祝日名、振替出勤、給与倍率などを確認できます。データは timor.tech の公開 API から取得します。

cyeam date holiday                  # 今天
cyeam date holiday 2026-10-01       # 指定日期
cyeam date holiday next-monday       # 不支持，只接受 YYYY-MM-DD

インストール

インストールする前に、以下のコマンドを確認してください。例では v1.1.4 に固定しており、latest には追従しません。ダウンロードするのは実行可能プログラムのアーカイブです。 CLI をインストールする必要がある場合にのみ実行してください。コマンドを呼び出すたびに再インストールする必要はありません。

macOS / Linux：検証後にユーザーディレクトリへインストール

Bash または Zsh で実行してください。curl、tar、install、および shasum または sha256sum が必要です。 スクリプトは macOS / Linux の arm64 または x86_64 を自動選択します。それ以外のプラットフォームでは停止します。

(
  set -eu
  version='v1.1.4'
  case "$(uname -s)/$(uname -m)" in
    Darwin/arm64)
      asset='cyeam_Darwin_arm64.tar.gz'
      sha256='06b5af004ab4f0f05d5829ea6bd18b97c4449c262af7df14c67175f7d3cb29db' ;;
    Darwin/x86_64)
      asset='cyeam_Darwin_x86_64.tar.gz'
      sha256='107342bb9d2fa444b96155c468e71b8cc63e0f5ad0acc784698afe221548efa6' ;;
    Linux/aarch64|Linux/arm64)
      asset='cyeam_Linux_arm64.tar.gz'
      sha256='ed87697f3948bead67b585e9881c3bef20e8d2d903beb5b125587281a5091c5b' ;;
    Linux/x86_64)
      asset='cyeam_Linux_x86_64.tar.gz'
      sha256='873d6805fab8ab56540bb034aaf2f57f12eb672fcabd322ebe401e8250a5966d' ;;
    *) echo '不支持的平台，请查看固定版本的 Release。' >&2; exit 1 ;;
  esac
  workdir=$(mktemp -d)
  trap 'rm -rf "$workdir"' EXIT
  cd "$workdir"
  curl --fail --show-error --silent --location --proto '=https' --proto-redir '=https' \
    --output "$asset" "https://github.com/mnhkahn/cyeam-cli/releases/download/$version/$asset"
  printf '%s  %s\n' "$sha256" "$asset" > expected.sha256
  if command -v sha256sum >/dev/null 2>&1; then
    sha256sum -c expected.sha256
  else
    shasum -a 256 -c expected.sha256
  fi
  # set -e 确保下载或校验失败时，不会解压或安装。
  tar -xzf "$asset" cyeam
  mkdir -p "$HOME/.local/bin"
  install -m 0755 cyeam "$HOME/.local/bin/cyeam"
  CYEAM_CLI_NO_UPDATE_NOTIFIER=1 "$HOME/.local/bin/cyeam" --no-analytics version
)

一時ディレクトリと ~/.local/bin/cyeam のみを書き込みます（同名のプログラムがすでにある場合は置き換えます）。管理者権限は不要です。 システムディレクトリ、サービス、シェル設定は変更しません。現在のシェルで使用するには、次を実行します。

export PATH="$HOME/.local/bin:$PATH"

永続的に有効にするには、上記の行をシェル設定に追加してください。 バージョン v1.1.4 のリリースページと checksums.txt でハッシュ値を確認できます。固定バージョンを更新する場合は、バージョン番号と対応する SHA-256 の両方を確認し、置き換えてください。 ハッシュ値はリリースファイルの整合性確認に使用するもので、独立した署名やセキュリティ監査と同等ではありません。

外部リクエストと権限の用途

• インストール時のダウンロード：GitHub から選択したアーカイブを、固定された Release URL でのみダウンロードします。GitHub はアセット CDN にリダイレクトする場合があります。 ダウンロード後、文書に記載された固定の SHA-256 を検証してから、単一の cyeam ファイルを展開します。インストール時のチェックでは、利用統計と更新通知は無効になります。
• 祝日検索：指定された年の祝日を取得するため、 https://timor.tech/api/holiday/year/<年份>?type=Y&weekday=Y にリクエストし、対象日の日付状態をローカルで計算します。ローカルファイルはアップロードせず、ログインも不要です。
• 利用統計：デフォルトでは、コマンド名、CLI のバージョン、システム情報、ランダムなインストール ID を https://us.i.posthog.com に送信します。サーバー側では、送信元 IP から地域を特定する場合があります。コマンド引数、画像の内容、ログイン認証情報は送信しません。 ランダム ID は ~/.cyeam/analytics-id に保存されます。--no-analytics または CYEAM_CLI_NO_ANALYTICS=1 で無効にできます。
• 更新通知：デフォルトでは、最長 24 時間ごとに GitHub で最新バージョンを確認し、~/.cyeam/update-state.json にキャッシュします。 通知によってプログラムが置き換えられることはありません。CYEAM_CLI_NO_UPDATE_NOTIFIER=1 で無効にできます。 cyeam update は明示的なアップグレードコマンドです。最新の Release をダウンロードして検証し、現在のプログラムを置き換えます。成功後は npx skills add による skills の同期も試みます。バージョンを固定する場合は実行せず、上記の手順で選択したバージョンをインストールしてください。

CLI の利用統計と更新通知を無効にするには（本来の機能で行うネットワークリクエストには影響しません）、現在のシェルで次を設定してください。

export CYEAM_CLI_NO_ANALYTICS=1
export CYEAM_CLI_NO_UPDATE_NOTIFIER=1

出力

日期: 2026-10-01
星期: 周四
状态: 休息日
名称: 国庆节
薪资倍数: 3

状態の説明

状態	意味
平日	通常の出勤日
休日	法定休日または週末
週末休み	週末
振替出勤	振替休日の調整による出勤日（例：国慶節前の週末）

注意事項

• 日付形式は YYYY-MM-DD である必要があります。引数を省略すると、デフォルトで今日の日付が使用されます
• ログインは不要です
• データの対象期間：現在は、発表済みの年間休日スケジュールのみをサポートしています。未発表の年については空の結果が返されます