DateAndTime.DatePart 方法 (String, Object, FirstDayOfWeek, FirstWeekOfYear)

傳回 Integer 值，其中包含指定的 Date 值的指定元件。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function DatePart ( _
    Interval As String, _
    DateValue As Object, _
    <OptionalAttribute> Optional DayOfWeek As FirstDayOfWeek = FirstDayOfWeek.Sunday, _
    <OptionalAttribute> Optional WeekOfYear As FirstWeekOfYear = FirstWeekOfYear.Jan1 _
) As Integer
'用途
Dim Interval As String
Dim DateValue As Object
Dim DayOfWeek As FirstDayOfWeek
Dim WeekOfYear As FirstWeekOfYear
Dim returnValue As Integer

returnValue = DateAndTime.DatePart(Interval, DateValue, DayOfWeek, WeekOfYear)

public static int DatePart (
    string Interval,
    Object DateValue,
    [OptionalAttribute] FirstDayOfWeek DayOfWeek,
    [OptionalAttribute] FirstWeekOfYear WeekOfYear
)

public:
static int DatePart (
    String^ Interval, 
    Object^ DateValue, 
    [OptionalAttribute] FirstDayOfWeek DayOfWeek, 
    [OptionalAttribute] FirstWeekOfYear WeekOfYear
)

public static int DatePart (
    String Interval, 
    Object DateValue, 
    /** @attribute OptionalAttribute() */ FirstDayOfWeek DayOfWeek, 
    /** @attribute OptionalAttribute() */ FirstWeekOfYear WeekOfYear
)

public static function DatePart (
    Interval : String, 
    DateValue : Object, 
    DayOfWeek : FirstDayOfWeek, 
    WeekOfYear : FirstWeekOfYear
) : int

參數

• Interval
  必要項。DateInterval 列舉值或 String 運算式，表示您想傳回的日期 / 時間值的部分。

• DateValue
  必要項。您想評估的 Date 值。

• DayOfWeek
  選擇項。選自 FirstDayOfWeek 列舉型別的值，指定一週的第一天。如果未指定，就會使用 FirstDayOfWeek.Sunday。

• WeekOfYear
  選擇項。選自 FirstWeekOfYear 列舉型別的值，指定一年的第一週。如果未指定，就會使用 FirstWeekOfYear.Jan1。

傳回值

傳回 Integer 值，其中包含指定的 Date 值的指定元件。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 DatePart 函式 (Visual Basic)。

您可使用 DatePart 函式來評估日期 / 時間值，並傳回特定的元件。例如，您可使用 DatePart 來計算星期幾或是目前的小時。

如果您在 Interval 引數上選擇 DateInterval.Weekday，則傳回的值會與 FirstDayOfWeek 列舉的值一致。如果您選擇 DateInterval.WeekOfYear，則 DatePart 會使用 System.Globalization 命名空間的 Calendar 和 CultureInfo 類別，以判斷目前的設定。

FirstDayOfWeekValue 引數會影響使用 DateInterval.Weekday 和 DateInterval.WeekOfYearInterval 設定的計算。FirstWeekOfYearValue 引數會影響在 Interval 上指定 DateInterval.WeekOfYear 的計算。

因為 DateTime 結構可支援每一個 Date 值，所以它在擷取日期 / 時間部分時，可為您提供一些額外的選項。例如，您可以取得 Date 變數的整個日期值，且其時間值設定為午夜，如下所示：

Dim CurrDatTim As Date = Now   ' Current date and time.
Dim LastMidnight As Date = CurrDatTim.Date   ' At midnight.

Interval 引數可以是下列設定之一。

列舉值	字串	要傳回的日期 / 時間值部分
DateInterval.Day	d	月中的日 (1 到 31)
DateInterval.DayOfYear	y	年中的日 (1 到 366)
DateInterval.Hour	h	時
DateInterval.Minute	n	分
DateInterval.Month	m	月份
DateInterval.Quarter	q	一季
DateInterval.Second	s	秒
DateInterval.Weekday	w	星期資訊 (1 到 7)
DateInterval.WeekOfYear	ww	年中的週 (1 到 53)
DateInterval.Year	yyyy	年

FirstDayOfWeekValue 引數可以是下列設定之一。

列舉值	值	描述
FirstDayOfWeek.System	0	系統設定中指定之一週的第一天
FirstDayOfWeek.Sunday	1	星期日 (預設值)
FirstDayOfWeek.Monday	2	星期一 (符合 ISO 標準 8601 的第 3.17 節)
FirstDayOfWeek.Tuesday	3	星期二
FirstDayOfWeek.Wednesday	4	星期三
FirstDayOfWeek.Thursday	5	星期四
FirstDayOfWeek.Friday	6	星期五
FirstDayOfWeek.Saturday	7	星期六

FirstWeekOfYearValue 引數可以是下列設定之一。

列舉值	值	描述
FirstWeekOfYear.System	0	系統設定中指定之一年的第一週
FirstWeekOfYear.Jan1	1	1 月 1 日所在的一週 (預設值)
FirstWeekOfYear.FirstFourDays	2	至少有四天在新的一年中的一週 (符合 ISO 標準 8601 之 3.17 節)
FirstWeekOfYear.FirstFullWeek	3	新年度的第一整週

範例

此範例會採用一個日期，以及使用 DatePart 函式來顯示其發生所在的年中的季。

Dim FirstDate, Msg As String   'Declare variables.
Dim SecondDate As Date
FirstDate = InputBox("Enter a date:")
SecondDate = CDate(FirstDate)
Msg = "Quarter: " & DatePart(DateInterval.Quarter, SecondDate)
MsgBox(Msg)

平台

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 命名空間
System

其他資源

DatePart 函式 (Visual Basic)
DateAdd 函式 (Visual Basic)
DateDiff 函式 (Visual Basic)
Day 函式 (Visual Basic)
Format 函式
Now 屬性
Weekday 函式 (Visual Basic)
Year 函式 (Visual Basic)
Date 資料型別 (Visual Basic)