DateAndTime.WeekdayName メソッド

.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)

C#

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
)

J#

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".

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DateAndTime クラス
DateAndTime メンバ
Microsoft.VisualBasic 名前空間
DateTime
その他の技術情報
WeekdayName 関数 (Visual Basic)
Day 関数 (Visual Basic)
Month 関数 (Visual Basic)
Now プロパティ
Weekday 関数 (Visual Basic)
MonthName 関数 (Visual Basic)
Year 関数 (Visual Basic)
DatePart 関数 (Visual Basic)