IsHoliday メソッド (Holiday)

特定の日付がHolidayオブジェクトに関連付けられているかどうかを返します。

構文

Visual Basic (宣言)
C#

Public Function IsHoliday( _
   ByVal date As Date _
) As Boolean

public bool IsHoliday( 
   DateTime date
)

パラメータ

date: 調査の対象となる日付
（System.DateTime 型）

戻り値の型

値	説明
True	指定された日付がForceWorkdayオブジェクトに関連付けられています。
False	指定された日付がForceWorkdayオブジェクトに関連付けられていません。

解説

IsHolidayメソッドは、指定された日付がForceWorkdayオブジェクトに関連付けられているかどうかを戻します。

このメソッドを使う機会はほとんどありませんが、下の使用例に示すように、IsYearlyプロパティと組み合わせて、臨時営業日に設定されている日がもともとはどの種類の日だったか調べるときなどに役立ちます。

臨時営業日の種類	IsHoliday	IsYearly
通常は休日	True + True	True + False
通常は臨時休日	True + True	False + False
通常は休業日	(False) + True	(False) + False

使用例

次のサンプルコードは、臨時営業日の内容を判別する例を示します。少なくとも１つのHolidayStyleが設定されていることを前提にしています。また、休日、臨時休日、および休業日なども事前に設定しておく必要があります。

Visual Basic
C#

Imports GrapeCity.Web.Input.IMCalendar

' チェック用の変数
Dim checkValue As Integer = 0

' 対象の日付を設定します。
Dim aDate As DateTime = DateTime.Parse("2015/3/23")

' 各オブジェクトのIsHolidayメソッドがTrueを返したときに、
' IsYearlyプロパティを調べます。
Dim aHS As HolidayStyle = GcCalendar1.HolidayStyles(GcCalendar1.ActiveHolidayStyles(0))
Dim item As IHoliday
For Each item In aHS.Holidays
    If item.IsHoliday(aDate) Then
        checkValue += 1
        If item.IsYearly Then checkValue += 3
    End If
Next

' 調べた結果を表示します。
Select checkValue
    Case 1
        Label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は休業日"
    Case 2
        Label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は臨時休日"
    Case 4
        Label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は休日"
End Select

using GrapeCity.Web.Input.IMCalendar;

// チェック用の変数
int checkValue = 0;

// 対象の日付を設定します。
DateTime aDate = DateTime.Parse("2015/3/23");

// 各オブジェクトのIsHolidayメソッドがTrueを返したときに、
// IsYearlyプロパティを調べます。
HolidayStyle aHS = GcCalendar1.HolidayStyles[GcCalendar1.ActiveHolidayStyles[0]];
foreach (IHoliday item in aHS.Holidays)
{
    if (item.IsHoliday(aDate))
    {
        checkValue += 1;
        if (item.IsYearly) checkValue += 3;
    }
}

// 調べた結果を表示します。
switch (checkValue)
{
    case 1:
        label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は休業日";
        break;
    case 2:
        label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は臨時休日";
        break;
    case 5:
        label1.Text = aDate.ToString("yyyy年MM月dd日") + " : 通常は休日";
        break;
}

参照

Holiday クラス
 Holiday メンバ