DateAndTime.DateDiff 메서드

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

public static long DateDiff(Microsoft.VisualBasic.DateInterval Interval, DateTime Date1, DateTime Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DateDiff : Microsoft.VisualBasic.DateInterval * DateTime * DateTime * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int64

Public Function DateDiff (Interval As DateInterval, Date1 As DateTime, Date2 As DateTime, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Long

매개 변수

반환

두 Date 값 사이의 시간 간격 수를 지정하는 긴 값입니다.

예외

예제

이 예제에서는 DateDiff 함수를 사용하여 지정된 날짜와 오늘 사이의 일 수를 표시합니다.

Dim date2Entered As String = InputBox("Enter a date")

Try
    Dim date2 As Date = Date.Parse(date2Entered)
    Dim date1 As Date = Now

    ' Determine the number of days between the two dates.
    Dim days As Long = DateDiff(DateInterval.Day, date1, date2)

    ' This statement has a string interval argument, and
    ' is equivalent to the above statement.
    'Dim days As Long = DateDiff("d", date1, date2)

    MessageBox.Show("Days from today: " & days.ToString)
Catch ex As Exception
    MessageBox.Show("Invalid Date: " & ex.Message)
End Try

설명

DateDiff 함수를 사용하여 두 날짜/시간 값 사이에 지정된 시간 간격의 수를 확인할 수 있습니다. 예를 들어 DateDiff 사용하여 두 날짜 사이의 일 수 또는 오늘과 연말 사이의 주 수를 계산할 수 있습니다.

행동

• 매개 변수 처리 DateDiff 차이를 생성하기 위해 Date2 값에서 Date1 값을 뺍니다. 호출 프로그램에서는 두 값이 모두 변경되지 않습니다.

• 값을 반환합니다. Date1 및 Date2Date 데이터 형식이므로 시스템 타이머에서 날짜 및 시간 값을 100나노초 틱으로 정확하게 유지합니다. 그러나 DateDiff 항상 시간 간격 수를 Long 값으로 반환합니다.

  Date1 Date2이후 날짜 및 시간을 나타내는 경우 DateDiff 음수를 반환합니다.

• 일 간격입니다. Interval DateInterval.DayOfYear설정된 경우 DayOfYear 시간 간격에 대한 의미 있는 단위가 아니므로 DateInterval.Day동일하게 처리됩니다.

• 주 간격입니다. Interval DateInterval.WeekOfYear설정된 경우 반환 값은 Date1 포함하는 요일과 Date2포함하는 요일 사이의 주 수를 나타냅니다. 다음 예제에서는 DateInterval.Weekday다른 결과를 생성하는 방법을 보여 줍니다.

  ' The following statements set datTim1 to a Thursday
  ' and datTim2 to the following Tuesday.
  Dim datTim1 As Date = #1/4/2001#
  Dim datTim2 As Date = #1/9/2001#
  ' Assume Sunday is specified as first day of the week.
  Dim wD As Long = DateDiff(DateInterval.Weekday, datTim1, datTim2)
  Dim wY As Long = DateDiff(DateInterval.WeekOfYear, datTim1, datTim2)
  

  앞의 예제에서 DateDiff 두 날짜 간의 차이가 7일 미만이므로 0에서 wD 반환하지만, 각 달력 주의 첫 번째 날짜 사이에 7일 간의 차이가 있기 때문에 1에서 wY 반환합니다.

• 더 큰 간격. Interval DateInterval.Year설정하면 반환 값은 Date1 및 Date2연도 부분에서만 계산됩니다. 마찬가지로 DateInterval.Month 반환 값은 인수의 연도 및 월 부분과 두 날짜가 포함된 분기의 DateInterval.Quarter 순수하게 계산됩니다.

  예를 들어 12월 31일과 다음 해 1월 1일을 비교할 때 DateDiffDateInterval.Year, DateInterval.Quarter또는 DateInterval.Month대해 1을 반환합니다.

  연대가 여러 개 있는 일본어와 같은 문화권의 경우 차이가 두 개 이상의 연대에 걸쳐 있는 경우 DateDiff 메서드는 연도의 차이를 반환하지 않습니다. 대신 다음 예제와 같이 Year 속성에서 반환되는 값의 차이를 계산할 수 있습니다. date2.Year - date1.Year.

• 기타 간격. 모든 Date 값은 DateTime 구조체에서 지원되므로 해당 메서드는 시간 간격을 찾는 추가 옵션을 제공합니다. 예를 들어 오버로드된 형식 중 하나에서 Subtract 메서드를 사용할 수 있습니다. DateTime.SubtractDate 변수에서 TimeSpan 빼서 다른 Date 값을 반환하고 DateTime.SubtractDate 값을 빼서 TimeSpan반환합니다. 다음 예제와 같이 프로세스 시간을 지정하여 걸리는 시간(밀리초)을 확인할 수 있습니다.

  Dim startTime As Date = Now
  ' Run the process that is to be timed.
  Dim runLength As Global.System.TimeSpan = Now.Subtract(startTime)
  Dim millisecs As Double = runLength.TotalMilliseconds
  

Interval 인수는 다음 설정 중 하나를 가질 수 있습니다.

DayOfWeek 인수는 다음 설정 중 하나를 가질 수 있습니다.

WeekOfYear 인수는 다음 설정 중 하나를 가질 수 있습니다.

추가 정보

• DateAdd
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• TimeSpan
• 데이터 형식 요약(Visual Basic)

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

Source:

DateAndTime.vb

public static long DateDiff(string Interval, object? Date1, object? Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

public static long DateDiff(string Interval, object Date1, object Date2, Microsoft.VisualBasic.FirstDayOfWeek DayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Microsoft.VisualBasic.FirstWeekOfYear WeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1);

static member DateDiff : string * obj * obj * Microsoft.VisualBasic.FirstDayOfWeek * Microsoft.VisualBasic.FirstWeekOfYear -> int64

Public Function DateDiff (Interval As String, Date1 As Object, Date2 As Object, Optional DayOfWeek As FirstDayOfWeek = Microsoft.VisualBasic.FirstDayOfWeek.Sunday, Optional WeekOfYear As FirstWeekOfYear = Microsoft.VisualBasic.FirstWeekOfYear.Jan1) As Long

매개 변수

반환

두 Date 값 사이의 시간 간격 수를 지정하는 긴 값입니다.

예외

예제

이 예제에서는 DateDiff 함수를 사용하여 지정된 날짜와 오늘 사이의 일 수를 표시합니다.

Dim date2Entered As String = InputBox("Enter a date")

Try
    Dim date2 As Date = Date.Parse(date2Entered)
    Dim date1 As Date = Now

    ' Determine the number of days between the two dates.
    Dim days As Long = DateDiff(DateInterval.Day, date1, date2)

    ' This statement has a string interval argument, and
    ' is equivalent to the above statement.
    'Dim days As Long = DateDiff("d", date1, date2)

    MessageBox.Show("Days from today: " & days.ToString)
Catch ex As Exception
    MessageBox.Show("Invalid Date: " & ex.Message)
End Try

설명

DateDiff 함수를 사용하여 두 날짜/시간 값 사이에 지정된 시간 간격의 수를 확인할 수 있습니다. 예를 들어 DateDiff 사용하여 두 날짜 사이의 일 수 또는 오늘과 연말 사이의 주 수를 계산할 수 있습니다.

행동

• 매개 변수 처리 DateDiff 차이를 생성하기 위해 Date2 값에서 Date1 값을 뺍니다. 호출 프로그램에서는 두 값이 모두 변경되지 않습니다.

• 값을 반환합니다. Date1 및 Date2Date 데이터 형식이므로 시스템 타이머에서 날짜 및 시간 값을 100나노초 틱으로 정확하게 유지합니다. 그러나 DateDiff 항상 시간 간격 수를 Long 값으로 반환합니다.

  Date1 Date2이후 날짜 및 시간을 나타내는 경우 DateDiff 음수를 반환합니다.

• 일 간격입니다. Interval DateInterval.DayOfYear설정된 경우 DayOfYear 시간 간격에 대한 의미 있는 단위가 아니므로 DateInterval.Day동일하게 처리됩니다.

• 주 간격입니다. Interval DateInterval.WeekOfYear설정된 경우 반환 값은 Date1 포함하는 요일과 Date2포함하는 요일 사이의 주 수를 나타냅니다. 다음 예제에서는 DateInterval.Weekday다른 결과를 생성하는 방법을 보여 줍니다.

  ' The following statements set datTim1 to a Thursday
  ' and datTim2 to the following Tuesday.
  Dim datTim1 As Date = #1/4/2001#
  Dim datTim2 As Date = #1/9/2001#
  ' Assume Sunday is specified as first day of the week.
  Dim wD As Long = DateDiff(DateInterval.Weekday, datTim1, datTim2)
  Dim wY As Long = DateDiff(DateInterval.WeekOfYear, datTim1, datTim2)
  

  앞의 예제에서 DateDiff 두 날짜 간의 차이가 7일 미만이므로 0에서 wD 반환하지만, 각 달력 주의 첫 번째 날짜 사이에 7일 간의 차이가 있기 때문에 1에서 wY 반환합니다.

• 더 큰 간격. Interval DateInterval.Year설정하면 반환 값은 Date1 및 Date2연도 부분에서만 계산됩니다. 마찬가지로 DateInterval.Month 반환 값은 인수의 연도 및 월 부분과 두 날짜가 포함된 분기의 DateInterval.Quarter 순수하게 계산됩니다.

  예를 들어 12월 31일과 다음 해 1월 1일을 비교할 때 DateDiffDateInterval.Year, DateInterval.Quarter또는 DateInterval.Month대해 1을 반환합니다.

  연대가 여러 개 있는 일본어와 같은 문화권의 경우 차이가 두 개 이상의 연대에 걸쳐 있는 경우 DateDiff 메서드는 연도의 차이를 반환하지 않습니다. 대신 다음 예제와 같이 Year 속성에서 반환되는 값의 차이를 계산할 수 있습니다. date2.Year - date1.Year.

• 기타 간격. 모든 Date 값은 DateTime 구조체에서 지원되므로 해당 메서드는 시간 간격을 찾는 추가 옵션을 제공합니다. 예를 들어 오버로드된 형식 중 하나에서 Subtract 메서드를 사용할 수 있습니다. DateTime.SubtractDate 변수에서 TimeSpan 빼서 다른 Date 값을 반환하고 DateTime.SubtractDate 값을 빼서 TimeSpan반환합니다. 다음 예제와 같이 프로세스 시간을 지정하여 걸리는 시간(밀리초)을 확인할 수 있습니다.

  Dim startTime As Date = Now
  ' Run the process that is to be timed.
  Dim runLength As Global.System.TimeSpan = Now.Subtract(startTime)
  Dim millisecs As Double = runLength.TotalMilliseconds
  

Interval 인수는 다음 설정 중 하나를 가질 수 있습니다.

DayOfWeek 인수는 다음 설정 중 하나를 가질 수 있습니다.

WeekOfYear 인수는 다음 설정 중 하나를 가질 수 있습니다.

추가 정보

• DateAdd
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• TimeSpan
• 데이터 형식 요약(Visual Basic)