MonthName 関数 (Visual Basic)

更新 : 2007 年 11 月

指定した月の名前を含む文字列型 (String) の値を返します。

Public Function MonthName( _
   ByVal Month As Integer, _
   Optional ByVal Abbreviate As Boolean = False _
) As String

パラメータ

  • Month
    必ず指定します。整数型 (Integer)。1 ~ 13 の数値で指定した月であり、1 は 1 月、12 は 12 月を表します。13 か月カレンダーでは、値 13 を使用できます。システムで 12 か月カレンダーが使用され、Month が 13 の場合、MonthName は空の文字列を返します。

  • Abbreviate
    省略可能です。月名を省略するかどうかを表すブール型 (Boolean) の値。省略すると、既定値の False が使用され、月名は短縮されません。

例外

例外の種類

エラー番号

条件

ArgumentException

5

Month が 1 より小さいか、または 13 を超えています。

非構造化エラー処理を使用する Visual Basic 6.0 アプリケーションをアップグレードする場合は、「エラー番号」列を参照してください(エラー番号を Number プロパティ (Err オブジェクト) と照らし合わせます)。しかし、可能な限り、このエラー処理は Visual Basic の構造化例外処理の概要 で置き換えてください。

解説

MonthName から返される文字列は、入力引数だけではなく、Windows のコントロール パネルで設定される [地域のオプション] にも依存します。

zxbsw165.alert_note(ja-jp,VS.90).gifメモ :

MonthName は、System.Globalization 名前空間にある CultureInfo クラスの CurrentCulture プロパティの現在のカレンダーの設定を使用します。CurrentCulture の既定値は、コントロール パネルの設定によって決まります。

使用例

次の例は、MonthName 関数を使って、指定された整数に対応する月の名前を取得します。ブール型の値によって、完全な名前 (False) と省略名 (True) のどちらを表示するかが決まります。

Dim thisMonth As Integer
Dim name As String
thisMonth = 4
' Set Abbreviate to True to return an abbreviated name.
name = MonthName(thisMonth, True)
' name now contains "Apr".

必要条件

名前空間 : Microsoft.VisualBasic

モジュール : DateAndTime

アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)

参照

参照

WeekdayName 関数 (Visual Basic)

System

System.Globalization

DateTime

ArgumentException

CultureInfo