📄 gregoriancalendar.cls
字号:
'
' @param Time The time to retrieve the second from.
' @return The second portion of the time.
'
Public Function GetSecond(ByRef Time As Variant) As Long
GetSecond = cDateTime.GetcDateTime(Time).Second
End Function
''
' Returns the week of the year that the specified date belongs to.
'
' @param Time The date to find the week it belongs.
' @param Rule Rule to decide what constitutes the first week of the year.
' @param FirstDayOfWeek Defines which week day is the start of a new week.
' @return The week that the date belongs to.
'
Public Function GetWeekOfYear(ByRef Time As Variant, ByVal Rule As CalendarWeekRule, ByVal FirstDayOfWeek As DayOfWeek) As Long
GetWeekOfYear = InternalGetWeekOfYear(Time, Rule, FirstDayOfWeek, Me)
End Function
''
' Returns the year of the specified time.
'
' @param Time The time to retrieve the year from.
' @return The year portion of the time.
'
Public Function GetYear(ByRef Time As Variant) As Long
GetYear = cDateTime.GetcDateTime(Time).Year
End Function
''
' Returns a boolean indicating if the specific day is a leap day.
'
' @param Year The year the day is in.
' @param Month The month the day is in.
' @param Day The day to check if is a leap day.
' @param Era The era the year is in.
' @return Boolean indication if the day is a leap day.
' @remarks A leap day only exists in a leap year, such as Febuary 29th in the Gregorian calendar.
'
Public Function IsLeapDay(ByVal Year As Long, ByVal Month As Long, ByVal Day As Long, Optional ByRef Era As Variant) As Boolean
Call VerifyEra(Era)
Call VerifyYear(Year)
Call VerifyMonth(Month)
If Day < 1 Or Day > GetDaysInMonth(Year, Month) Then _
Throw Cor.NewArgumentOutOfRangeException(Environment.GetResourceString(ArgumentOutOfRange_Range, 1, GetDaysInMonth(Year, Month)), "Day", Day)
If Month = 2 Then
IsLeapDay = (Day = 29)
End If
End Function
''
' Returns a boolean indicating if the specific month is a leap month.
'
' @param Year The year the month is in.
' @param Month The month to check if it is a leap month.
' @param Era The era the year is in.
' @return Boolean indication if the month is a leap month.
' @remarks A leap month only exists in a leap year, such as Adar II in the Hebrew calendar.
' This always returns <b>False</b>.
'
Public Function IsLeapMonth(ByVal Year As Long, ByVal Month As Long, Optional ByRef Era As Variant) As Boolean
Call VerifyEra(Era)
Call VerifyYear(Year)
Call VerifyMonth(Month)
IsLeapMonth = False
End Function
''
' Returns a boolean indicating if the specific year is a leap year.
'
' @param Year The year to check if is a leap year.
' @param Era The era the year is in.
' @return Boolean indication if the year is a leap year.
' @remarks A leap year in the Gregorian calendar occurs when the year is
' evenly divisible by 4, but not by 100, unless it is divisible by 400.
'
Public Function IsLeapYear(ByVal Year As Long, Optional ByRef Era As Variant) As Boolean
Call VerifyEra(Era)
Call VerifyYear(Year)
IsLeapYear = cDateTime.IsLeapYear(Year)
End Function
''
' Returns a Gregorian cDateTime computed using the specific calendar rules.
'
' @param Year The Year in the specific calendar type.
' @param Month The Month in the specific calendar type.
' @param Day The Day in the specific calendar type.
' @param Hour The hour for the new time.
' @param Minute The minute for the new time.
' @param Second The second for the new time.
' @param Millisecond The milliseconds for the new time.
' @param Era The era the year is in.
' @return A Gregorian version of the date specified.
'
Public Function ToDateTime(ByVal Year As Long, ByVal Month As Long, ByVal Day As Long, ByVal Hour As Long, ByVal Minute As Long, ByVal Second As Long, ByVal Millisecond As Long, Optional ByRef Era As Variant) As cDateTime
Call VerifyEra(Era)
Set ToDateTime = Cor.NewcDateTime(Year, Month, Day, Hour, Minute, Second, Millisecond)
End Function
''
' Returns a 4-digit year from a 2-digit number.
'
' @param Year The year to be converted to 4-digits.
' @return A 4-digit year in the specific calendar.
' @remarks A normal way of dealing with years is by refering to them as a
' 2-digit value. This is evident in the Gregorian calendar system. The
' year 2005 may be referenced as '05 (pronounced oh-five). When converting
' a 2-digit year to a 4-digit the century is unknown. '05 could be 2005 or 1905.
' This property gives the calendar a rule to follow when converting 2-digit years
' to 4-digit.
' <p>A max year of 2029 will cause a minimum year of 1930. These two years represent
' 100 years which 2-digit years will fall. 00-99 will fall within 1930-2029.</p>
'
Public Function ToFourDigitYear(ByVal Year As Long) As Long
If Year < 0 Or Year > 9999 Then _
Throw Cor.NewArgumentOutOfRangeException(Environment.GetResourceString(ArgumentOutOfRange_Range, 0, 9999), "Year", Year)
If Year < 100 Then
Dim y As Long
y = Year Mod 100
ToFourDigitYear = (mTwoDigitYearMax \ 100) * 100 + y
If y > mTwoDigitYearMax Mod 100 Then ToFourDigitYear = ToFourDigitYear - 100
Else
ToFourDigitYear = Year
End If
End Function
''
' Returns a string representation of this object instance.
'
' @return String representing this instance.
Public Function ToString() As String
ToString = Object.ToString(Me, App)
End Function
''
' Returns a boolean indicating if the value and this object
' instance are the same instance.
'
' @param value The value to compare equalit to.
' @return Boolean indicating equality.
Public Function Equals(ByRef Value As Variant) As Boolean
Equals = Object.Equals(Me, Value)
End Function
''
' Returns a pseudo-unique number identifying this instance.
'
' @return Pseudo-unique number identifying this instance.
Public Function GetHashCode() As Long
GetHashCode = ObjPtr(CUnk(Me))
End Function
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Friend Interface
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Friend Sub Init(ByVal CalendarType As GregorianCalendarTypes)
mCalendarType = CalendarType
End Sub
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Private Helpers
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Private Sub VerifyEra(ByRef Era As Variant)
If IsMissing(Era) Then Exit Sub
Select Case VarType(Era)
Case vbLong, vbInteger, vbByte
If Era < 0 Or Era > 1 Then Throw Cor.NewArgumentException(Environment.GetResourceString(Argument_InvalidEraValue), "Era")
Case Else
Throw Cor.NewInvalidCastException("An integer value is required.")
End Select
End Sub
Private Sub VerifyYear(ByVal Year As Long)
If Year < 1 Or Year > 9999 Then Throw Cor.NewArgumentOutOfRangeException(Environment.GetResourceString(ArgumentOutOfRange_Range, 1, 9999), "Year", Year)
End Sub
Private Sub VerifyMonth(ByVal Month As Long)
If Month < 1 Or Month > 12 Then Throw Cor.NewArgumentOutOfRangeException(Environment.GetResourceString(ArgumentOutOfRange_Range, 1, 12), "Month", Month)
End Sub
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Calendar Interface
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Private Function Calendar_AddDays(Time As Variant, ByVal Days As Long) As cDateTime
Set Calendar_AddDays = AddDays(Time, Days)
End Function
Private Function Calendar_AddHours(Time As Variant, ByVal Hours As Long) As cDateTime
Set Calendar_AddHours = AddHours(Time, Hours)
End Function
Private Function Calendar_AddMilliseconds(Time As Variant, ByVal Milliseconds As Double) As cDateTime
Set Calendar_AddMilliseconds = AddMilliseconds(Time, Milliseconds)
End Function
Private Function Calendar_AddMinutes(Time As Variant, ByVal Minutes As Long) As cDateTime
Set Calendar_AddMinutes = AddMinutes(Time, Minutes)
End Function
Private Function Calendar_AddMonths(Time As Variant, ByVal Months As Long) As cDateTime
Set Calendar_AddMonths = AddMonths(Time, Months)
End Function
Private Function Calendar_AddSeconds(Time As Variant, ByVal Seconds As Long) As cDateTime
Set Calendar_AddSeconds = AddSeconds(Time, Seconds)
End Function
Private Function Calendar_AddWeeks(Time As Variant, ByVal Weeks As Long) As cDateTime
Set Calendar_AddWeeks = AddWeeks(Time, Weeks)
End Function
Private Function Calendar_AddYears(Time As Variant, ByVal Years As Long) As cDateTime
Set Calendar_AddYears = AddYears(Time, Years)
End Function
Private Function Calendar_Equals(Value As Variant) As Boolean
Calendar_Equals = Equals(Value)
End Function
Private Property Get Calendar_Eras() As Long()
Calendar_Eras = Eras
End Property
Private Function Calendar_GetDayOfMonth(Time As Variant) As Long
Calendar_GetDayOfMonth = GetDayOfMonth(Time)
End Function
Private Function Calendar_GetDayOfWeek(Time As Variant) As DayOfWeek
Calendar_GetDayOfWeek = GetDayOfWeek(Time)
End Function
Private Function Calendar_GetDayOfYear(Time As Variant) As Long
Calendar_GetDayOfYear = GetDayOfYear(Time)
End Function
Private Function Calendar_GetDaysInMonth(ByVal Year As Long, ByVal Month As Long, Optional Era As Variant) As Long
Calendar_GetDaysInMonth = GetDaysInMonth(Year, Month, Era)
End Function
Private Function Calendar_GetDaysInYear(ByVal Year As Long, Optional Era As Variant) As Long
Calendar_GetDaysInYear = GetDaysInYear(Year, Era)
End Function
Private Function Calendar_GetEra(Time As Variant) As Long
Calendar_GetEra = GetEra(Time)
End Function
Private Function Calendar_GetHashCode() As Long
Calendar_GetHashCode = GetHashCode
End Function
Private Function Calendar_GetHour(Time As Variant) As Long
Calendar_GetHour = GetHour(Time)
End Function
Private Function Calendar_GetMilliseconds(Time As Variant) As Double
Calendar_GetMilliseconds = GetMilliseconds(Time)
End Function
Private Function Calendar_GetMinute(Time As Variant) As Long
Calendar_GetMinute = GetMinute(Time)
End Function
Private Function Calendar_GetMonth(Time As Variant) As Long
Calendar_GetMonth = GetMonth(Time)
End Function
Private Function Calendar_GetMonthsInYear(ByVal Year As Long, Optional Era As Variant) As Long
Calendar_GetMonthsInYear = GetMonthsInYear(Year, Era)
End Function
Private Function Calendar_GetSecond(Time As Variant) As Long
Calendar_GetSecond = GetSecond(Time)
End Function
Private Function Calendar_GetWeekOfYear(Time As Variant, ByVal Rule As CalendarWeekRule, ByVal FirstDayOfWeek As DayOfWeek) As Long
Calendar_GetWeekOfYear = GetWeekOfYear(Time, Rule, FirstDayOfWeek)
End Function
Private Function Calendar_GetYear(Time As Variant) As Long
Calendar_GetYear = GetYear(Time)
End Function
Private Function Calendar_IsLeapDay(ByVal Year As Long, ByVal Month As Long, ByVal Day As Long, Optional Era As Variant) As Boolean
Calendar_IsLeapDay = IsLeapDay(Year, Month, Day, Era)
End Function
Private Function Calendar_IsLeapMonth(ByVal Year As Long, ByVal Month As Long, Optional Era As Variant) As Boolean
Calendar_IsLeapMonth = IsLeapMonth(Year, Month, Era)
End Function
Private Function Calendar_IsLeapYear(ByVal Year As Long, Optional Era As Variant) As Boolean
Calendar_IsLeapYear = IsLeapYear(Year, Era)
End Function
Private Function Calendar_ToDateTime(ByVal Year As Long, ByVal Month As Long, ByVal Day As Long, ByVal Hour As Long, ByVal Minute As Long, ByVal Second As Long, ByVal Millisecond As Long, Optional Era As Variant) As cDateTime
Set Calendar_ToDateTime = ToDateTime(Year, Month, Day, Hour, Minute, Second, Millisecond, Era)
End Function
Private Function Calendar_ToFourDigitYear(ByVal Year As Long) As Long
Calendar_ToFourDigitYear = ToFourDigitYear(Year)
End Function
Private Function Calendar_ToString() As String
Calendar_ToString = ToString
End Function
Private Property Let Calendar_TwoDigitYearMax(ByVal RHS As Long)
TwoDigitYearMax = RHS
End Property
Private Property Get Calendar_TwoDigitYearMax() As Long
Calendar_TwoDigitYearMax = TwoDigitYearMax
End Property
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Class events
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Private Sub Class_InitProperties()
mTwoDigitYearMax = GetCalendarLong(CAL_GREGORIAN, CAL_ITWODIGITYEARMAX)
mCalendarType = GregorianCalendarTypes.Localized
End Sub
Private Sub Class_ReadProperties(PropBag As PropertyBag)
With PropBag
mTwoDigitYearMax = .ReadProperty("TwoDigitYearMax")
mCalendarType = .ReadProperty("CalendarType")
End With
End Sub
Private Sub Class_WriteProperties(PropBag As PropertyBag)
Call PropBag.WriteProperty("TwoDigitYearMax", mTwoDigitYearMax)
Call PropBag.WriteProperty("CalendarType", mCalendarType)
End Sub
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' IObject Interface
'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Private Function IObject_Equals(Value As Variant) As Boolean
IObject_Equals = Equals(Value)
End Function
Private Function IObject_GetHashcode() As Long
IObject_GetHashcode = GetHashCode
End Function
Private Function IObject_ToString() As String
IObject_ToString = ToString
End Function
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -