DateAndTime.WeekdayName メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DateAndTime.WeekdayName メソッド

指定した曜日の名前を含む String 値を返します。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function WeekdayName
 ( _
    Weekday As Integer, _
    <OptionalAttribute> Optional Abbreviate As
 Boolean = False, _
    <OptionalAttribute> Optional FirstDayOfWeekValue As
 FirstDayOfWeek = FirstDayOfWeek.System _
) As String

Visual Basic (使用法)

Dim Weekday As Integer
Dim Abbreviate As Boolean
Dim FirstDayOfWeekValue As FirstDayOfWeek
Dim returnValue As String

returnValue = DateAndTime.WeekdayName(Weekday, Abbreviate, FirstDayOfWeekValue)

public static string WeekdayName
 (
    int Weekday,
    [OptionalAttribute] bool Abbreviate,
    [OptionalAttribute] FirstDayOfWeek FirstDayOfWeekValue
)

C++

public:
static String^ WeekdayName (
    int Weekday, 
    [OptionalAttribute] bool Abbreviate, 
    [OptionalAttribute] FirstDayOfWeek FirstDayOfWeekValue
)

public static String WeekdayName (
    int Weekday, 
    /** @attribute OptionalAttribute() */ boolean Abbreviate, 
    /** @attribute OptionalAttribute() */ FirstDayOfWeek FirstDayOfWeekValue
)

JScript

public static function WeekdayName
 (
    Weekday : int, 
    Abbreviate : boolean, 
    FirstDayOfWeekValue : FirstDayOfWeek
) : String

パラメータ

Weekday: 必須。Integer。曜日を指定する 1 ～ 7 の数値。1 は週の最初の曜日を表し、7 は週の最後の曜日を表します。最初と最後の曜日は、FirstDayOfWeekValue の設定により決まります。

Abbreviate: 省略可能。曜日の名前を省略するかどうかを表す Boolean 値。省略した場合、既定値の False が使用され、曜日の名前は省略されません。

FirstDayOfWeekValue: 省略可能。週の最初の曜日を指定する FirstDayOfWeek 列挙体から選択する値。指定しない場合は、FirstDayOfWeek.System が使用されます。

戻り値
指定した曜日の名前を含む String 値を返します。

解説

詳細については、Visual Basic のトピック「WeekdayName 関数 (Visual Basic)」を参照してください。

WeekdayName により返される文字列は、入力された引数だけでなく、Windows の [コントロールパネル] で指定されている [地域のオプション] の設定にも影響されます。

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

FirstDayOfWeekValue 引数には、次の設定値の 1 つを指定できます。

列挙値	値	説明
FirstDayOfWeek.System	0	システム設定で指定されている、週の最初の曜日 (既定)
FirstDayOfWeek.Sunday	1	Sunday
FirstDayOfWeek.Monday	2	月曜日 (ISO 規格 8601、セクション 3.17 に準拠)
FirstDayOfWeek.Tuesday	3	Tuesday
FirstDayOfWeek.Wednesday	4	Wednesday
FirstDayOfWeek.Thursday	5	Thursday
FirstDayOfWeek.Friday	6	Friday
FirstDayOfWeek.Saturday	7	Saturday

使用例

次に示す例では、Weekday 関数を使用して、指定された日付から曜日を取得します。その後、WeekDayName 関数を使用してその数値から曜日の名前を取得します。

Visual Basic

Dim oldDate As Date
Dim oldWeekDayName As String
oldDate = #2/12/1969#
oldWeekDayName = WeekdayName(Weekday(oldDate))
' oldWeekDayName now contains "Wednesday".