【PowerShell】Get-Dateで実現する年月取得と日付操作の活用法

2025-09-26更新日: 2025-09-26

PowerShellでは、現在の年月を手軽に取得できる機能が用意されています。

基本のコマンドはGet-Date -Format "yyyyMM"で、これにより指定した形式で当月が出力されます。

また、日付の加減算が可能なため、月単位の調整も容易に行える点が魅力です。

用途に合わせた柔軟な運用が期待でき、シンプルながらも非常に便利な方法です。

目次から探す

PowerShellの基本知識
- PowerShellの役割と特徴
- コマンドレットの概念
Get-Dateコマンドレットの基礎
- Get-Dateの動作概要
- フォーマット指定の詳細
年月取得の実装方法
- 現在の年月取得の構文
- 日付加減算による年月計算
柔軟な日付操作の拡張例
- 複数メソッドの組み合わせ活用
- 業務プロセスへの統合事例
注意点と対処方法
まとめ

PowerShellの基本知識

PowerShellの役割と特徴

PowerShellは、Windows環境をはじめとする様々なシステム管理タスクを自動化するためのツールです。

直感的に操作できるコマンドレットが豊富で、複雑な処理もシンプルなスクリプトで実現できる点が魅力です。

ファイル操作、システム管理、アプリケーションの自動化など、幅広い用途に対応するため、管理者や開発者に支持されています。

コマンドレットの概念

PowerShellでは「コマンドレット」と呼ばれる、小さくて分かりやすい処理単位が利用されます。

各コマンドレットは、特定の処理を実行するために設計されており、パイプラインで連携することで、柔軟なデータ操作が可能となっています。

シンプルな文法と豊富なオプションがあるため、初心者でも取り組みやすい設計になっています。

Get-Dateコマンドレットの基礎

Get-Dateの動作概要

Get-Dateは、システムの現在の日付と時刻を取得するためのコマンドレットです。

シンプルな構文で使えるため、日付情報を操作したいときにとても便利です。

日付オブジェクト生成の流れ

Get-Dateを実行すると、内部で日付や時刻の情報が含まれるオブジェクトが生成されます。

これにより、細かな日付操作やフォーマット指定が簡単に行えます。

例えば、現在の日付を取得する基本的なコードは下記の通りです。

# 現在の日付と時刻を取得する

$currentDate = Get-Date

# 結果を表示

Write-Output $currentDate

2023/10/17 14:35:22  # 実行日時に応じた結果が表示されます

基本動作の仕組み

sGet-Dateは、システムの内部時計にアクセスして現在の日時情報を取得します。

返されるオブジェクトは、日時の各コンポーネント(年、月、日、時、分、秒など)を保持しているため、各部分に対して個別の操作が可能となっています。

フォーマット指定の詳細

Get-Dateでは、-Formatパラメータを使用することで、取得する日時の表示形式をカスタマイズできます。

多様な書式指定子が利用でき、組み合わせることで目的に合わせた出力が実現できます。

標準フォーマットとカスタムフォーマット

標準フォーマットは、短い記述で一般的な日時形式を得るために用意されています。

一方、カスタムフォーマットは、独自の表示様式が必要なときに、詳細なフォーマットが設定できるように設計されています。

たとえば、以下は標準フォーマット(ShortDate)とカスタムフォーマット(yyyy/MM/dd)の例です。

標準フォーマット例

# ショート日付形式で表示

Get-Date -Format "d"

カスタムフォーマット例

# yyyy/MM/dd形式で表示する

Get-Date -Format "yyyy/MM/dd"

書式パターン「yyyyMM」の解説

「yyyyMM」というフォーマットパターンは、年と月の情報だけを取得する際に使用されます。

西暦の4桁の年と2桁の月が連続して表示されるため、年月の記録や比較に便利な形式です。

例えば、現在の年月を取得する場合は次のように記述します。

# 現在の年月をyyyyMM形式で取得する

$currentYearMonth = Get-Date -Format "yyyyMM"
Write-Output $currentYearMonth  # 例: 202504

202504  # 実行日時に応じた結果が表示されます

年月取得の実装方法

現在の年月取得の構文

シンプルな取得方法

シンプルな年月取得は、Get-Dateとフォーマット指定を組み合わせるだけで実現できます。

コードは非常にシンプルで、理解しやすく、すぐに試すことができます。

# 現在の年月をyyyyMM形式で取得するシンプルな例

$currentYearMonth = Get-Date -Format "yyyyMM"
Write-Output "現在の年月: $currentYearMonth"

現在の年月: 202504  # 実行日時に応じた結果が表示されます

フォーマット指定のポイント

フォーマット指定で大切なのは、適切な書式パターンを選択することです。

yyyyMMは年と月にフォーカスした形式ですが、他にも日付や時刻に特化したパターンが用意されており、用途に合わせて変更可能です。

書式文字列は、次のような要素で構成されます。

書式文字列	出力内容
yyyy	4桁の年
MM	2桁の月
dd	2桁の日

上記の例では、年月のみを取り出すためにyyyyMMを利用しています。

日付加減算による年月計算

AddMonthsメソッドの利用

AddMonthsメソッドは、現在の日付から指定した月数を加算または減算するために利用されます。

シンプルに過去や未来の年月を取得する場合にとても便利です。

# 3ヶ月前の年月をyyyyMM形式で取得する

pastYearMonth = (Get-Date).AddMonths(-3).ToString("yyyyMM")
Write-Output "3ヶ月前の年月: $pastYearMonth"

3ヶ月前の年月: 202501  # 実行日時に応じた結果が表示されます

過去および未来の年月取得

AddMonthsメソッドを用いることで、過去だけでなく未来の年月も同様に計算できます。

たとえば、翌月や1年後の年月も簡単に取得できます。

以下は例として、翌月と1年後の年月取得方法を示すコードです。

# 翌月の年月を取得

nextMonth = (Get-Date).AddMonths(1).ToString("yyyyMM")
Write-Output "翌月の年月: $nextMonth"

# 1年後の年月を取得

nextYear = (Get-Date).AddMonths(12).ToString("yyyyMM")
Write-Output "1年後の年月: $nextYear"

翌月の年月: 202505
1年後の年月: 202604  # 実行日時に応じた結果が表示されます

柔軟な日付操作の拡張例

複数メソッドの組み合わせ活用

日付オブジェクトのカスタマイズ

Get-Dateで取得した日付オブジェクトは、複数のメソッドと組み合わせることで、さらに柔軟な操作が可能になります。

例えば、日付の各要素を別々に抽出したり、特定の時間帯のみを処理することができます。

次の例は、日、月、年の情報をそれぞれ変数に格納し、カスタマイズして出力するコードです。

# 現在の日付オブジェクトを取得

currentDate = Get-Date

# 年、月、日を個別に取得

year = currentDate.Year
month = currentDate.Month
day = currentDate.Day

# フォーマットを整えて出力

Write-Output "年: $year, 月: $month, 日: $day"

年: 2024, 月: 4, 日: 27  # 実行日時に応じた結果が表示されます

複合的な計算手法

加減算処理とフォーマット指定を組み合わせることで、もっと複雑な日時設定が実現可能です。

たとえば、ビジネスの締め切りや支払い期日の計算などが挙げられます。

加減算と変換を組み合わせると、自由な形式にカスタマイズできるため、特定のニーズに応じた計算が簡単に扱えます。

# 60日後の年月日を取得する例

futureDate = (Get-Date).AddDays(60)
formattedFutureDate = futureDate.ToString("yyyy/MM/dd")
Write-Output "60日後の日付: $formattedFutureDate"

60日後の日付: 2024/06/26  # 実行日時に応じた結果が表示されます

業務プロセスへの統合事例

スクリプト保守における留意点

PowerShellのスクリプトを業務プロセスに組み込む際、保守性が求められます。

コードの可読性やエラーハンドリング、コメントの充実を心がけることで、後からの見直しや修正がスムーズに進みます。

特に、年月や日付の計算を行う部分は、将来の変更に対応しやすいようにしっかりと構造化することが大切です。

例として、環境変数や設定ファイルからパラメータを取得する仕組みを導入すると、スクリプト全体の柔軟性が向上します。

# 例: 外部から月数を指定して年月を計算するスクリプト

# 外部パラメータ(例: -3 で3ヶ月前、5 で5ヶ月後)を利用して計算

param (
    [int]$OffsetMonths = 0  # 月数オフセット
)

# 指定された月数分を加減算して年月を取得

resultYearMonth = (Get-Date).AddMonths($OffsetMonths).ToString("yyyyMM")
Write-Output "オフセット月数($OffsetMonths)の年月: $resultYearMonth"

オフセット月数(-3)の年月: 202501  # オフセットに応じた実行結果が表示されます

業務フローへの応用

業務シナリオに応じて、日付操作は様々なプロセスに組み込めます。

たとえば、自動レポート生成時にタイムスタンプとして利用する、または月次処理や財務レポートで年月情報をキーとして扱うことができます。

これにより、システム全体の自動化と効率化が促進され、業務フローの改善に寄与します。

注意点と対処方法

フォーマット指定時の落とし穴

フォーマット指定文字列に誤りがあると、意図しない出力がされることがあるので気を付ける必要があります。

例えば、大文字と小文字の区別が重要となるため、正確な指定が求められます。

また、日付部分の不足や余計な文字列が混入しないように注意して記述すると良いです。

例: “yyyy/MM”と”YYYY/mm”は異なる結果になる

誤った指定により、期待する結果と異なる出力になる可能性があるため、ドキュメントも参考に正確な書式を確認してください。

タイムゾーンとローカル設定の影響

システムのタイムゾーンやローカル設定によって、取得する日時が異なる場合があります。

特にグローバルな環境では、タイムゾーンが統一されていないと日時データにずれが生じる可能性があるため、明示的にタイムゾーンを指定するか、UTCで扱う工夫が必要です。

項目	内容
システムタイムゾーン	OSの設定に依存し、出力結果に影響を与える
PowerShellのオプション	必要な場合、タイムゾーンの調整を行うオプションが用意されている

エラー発生時の対処方法

日付の操作では、予期せぬ入力や計算結果からエラーが発生することがあります。

エラーが発生した場合は、try-catch構文を利用してエラーメッセージを取得し、原因を特定することが推奨されます。

また、入力値の検証を事前に行うことでも、未然にエラーを防ぐことができるため、スクリプトを堅牢に保つ工夫が大切です。

# エラーハンドリングを行ったサンプルコード

try {

    # 例えば、日付操作の際に不正なオフセット値が渡された場合を想定

    result = (Get-Date).AddMonths("不正な値").ToString("yyyyMM")
    Write-Output $result
}
catch {
    Write-Output "エラーが発生しました。入力値を確認してください。"
}

エラーが発生しました。入力値を確認してください。  # 不正な入力時の例

まとめ

今回紹介した内容は、PowerShellを利用して日付操作や年月取得を柔軟に行う方法の基本的な部分をカバーしています。

各種メソッドやフォーマットの指定方法を活用すれば、実務での自動化やスクリプト作成に役立つ機能が多く見つかるはずです。

ぜひ、実際にサンプルコードを試していただき、ご自身の環境に合った調整を行いながら、より便利なスクリプト作成に役立ててもらえたら嬉しいです。

参考文献

Get-Date (Microsoft.PowerShell.Utility) – PowerShell | Microsoft Learn