Calendar

page_type	languages	products	urlFragment	extendedZipContent	description
sample	csharp cpp cppcx cppwinrt vb	windows windows-uwp	Calendar	path target SharedContent SharedContent path target LICENSE LICENSE	Shows how to use the Calendar class to manipulate and process dates based on a calendar system and the user's globalization preferences.

Calendar sample

Shows how to use the Calendar class in the Windows.Globalization namespace to manipulate and process dates based on a calendar system and the user's globalization preferences. (If you are looking for a sample which demonstrates an appointment calendar, see the Appointments sample.)

Note: This sample is part of a large collection of UWP feature samples. You can download this sample as a standalone ZIP file from docs.microsoft.com, or you can download the entire collection as a single ZIP file, but be sure to unzip everything to access shared dependencies. For more info on working with the ZIP file, the samples collection, and GitHub, see Get the UWP samples from GitHub. For more samples, see the Samples portal on the Windows Dev Center.

The Calendar class provides details of the user's default calendar or a caller-specified calendar system. The class gives access to specific statistical details as well as the ability to perform calendar-aware math operations.

The Calendar object can convert to and from a language-specific date type:

• C++: Windows::Foundation::DateTime
• C#: DateTimeOffset
• JavaScript: Date

The sample also uses the Windows.Globalization.CalendarIdentifiers and Windows.Globalization.ClockIdentifiers classes.

This sample contains scenarios that demonstrate:

• How to create a calendar for the user's default preferences or for specific overrides, and how to display calendar details.

• How to determine statistics for the current calendar date and time, such as the number of days in this month and the number of months in this year.

• How to enumerate through a calendar and perform calendar math, such as determining the number of hours in a day that spans the transition from Daylight Saving Time. This scenario also demonstrates converting from a language-specific date type to a Calendar.

• How to create a calendar using language names with supported Unicode extension tags, and how the extension tags are used by the calendar object.

• How to support time zones in calendars, by changing several time zones within a calendar and showing the effect of the time zone change in the date and time properties of the calendar.

• How to convert between calendars and a language-specific date type.

Related topics

Reference

Windows.Globalization.Calendar
Windows.Globalization.CalendarIdentifiers
Windows.Globalization.ClockIdentifiers

Related samples

• DateTimeFormatting sample
• GlobalizationPreferences sample
• NumberFormatting sample
• Calendar sample for JavaScript (archived)

System requirements

• Windows 10

Build the sample

1. If you download the samples ZIP, be sure to unzip the entire archive, not just the folder with the sample you want to build.
2. Start Microsoft Visual Studio and select File > Open > Project/Solution.
3. Starting in the folder where you unzipped the samples, go to the Samples subfolder, then the subfolder for this specific sample, then the subfolder for your preferred language (C++, C#, or JavaScript). Double-click the Visual Studio Solution (.sln) file.
4. Press Ctrl+Shift+B, or select Build > Build Solution.

Run the sample

The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.

Deploying the sample

• Select Build > Deploy Solution.

Deploying and running the sample

• To debug the sample and then run it, press F5 or select Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or select Debug > Start Without Debugging.