Universal Windows Platform (UWP) development is a powerful way to create modern Windows applications. Today, we will explain in detail how to handle dates and times in UWP. To aid in a deep understanding, we will include UWP’s date and time-related APIs, available data formats, example code, and practical tips.<\/p>\n
Dates and times are critical elements in most applications. User activity logs, event schedules, timers, and many other functions are based on dates and times. UWP offers various classes and methods for managing dates and times. By using these classes, developers can easily manipulate dates and times in the desired format.<\/p>\n
DateTime<\/code> Class<\/h3>\nThe DateTime<\/code> class is the most fundamental class representing dates and times. This class provides functionalities for date and time calculations, formatting, and comparisons.<\/p>\n2.1.1. Creating a DateTime<\/code><\/h4>\nA DateTime<\/code> object can be created using various constructors. Here are a few examples:<\/p>\nusing System;\n\nDateTime now = DateTime.Now; \/\/ Current date and time\nDateTime specificDate = new DateTime(2023, 10, 1); \/\/ Specific date\nDateTime withTime = new DateTime(2023, 10, 1, 15, 30, 0); \/\/ Specific date and time<\/code><\/pre>\n2.1.2. Formatting Date and Time<\/h4>\n
You can specify the format when converting a DateTime<\/code> object to a string. Here are examples of formatting:<\/p>\nusing System;\n\nDateTime date = new DateTime(2023, 10, 1);\nstring formattedDate = date.ToString(\"yyyy-MM-dd\"); \/\/ \"2023-10-01\"\nstring formattedTime = date.ToString(\"HH:mm:ss\"); \/\/ \"00:00:00\"<\/code><\/pre>\n2.2. TimeSpan<\/code> Class<\/h3>\nThe TimeSpan<\/code> class represents the interval of time between two dates. It allows developers to calculate or compare time intervals.<\/p>\n2.2.1. Creating a TimeSpan<\/code><\/h4>\nusing System;\n\nTimeSpan duration = new TimeSpan(1, 30, 0); \/\/ 1 hour 30 minutes\nTimeSpan difference = new DateTime(2023, 10, 1) - new DateTime(2023, 9, 30); \/\/ 1 day\n<\/code><\/pre>\n2.2.2. Using TimeSpan<\/code><\/h4>\nA TimeSpan<\/code> object provides several useful properties and methods:<\/p>\nusing System;\n\nTimeSpan timeSpan = new TimeSpan(2, 30, 0); \/\/ 2 hours 30 minutes\nint totalHours = (int)timeSpan.TotalHours; \/\/ Total hours\nint totalMinutes = (int)timeSpan.TotalMinutes; \/\/ Total minutes<\/code><\/pre>\n3. Using Date and Time APIs<\/h2>\n3.1. DateTimeOffset<\/code> Class<\/h3>\nThe DateTimeOffset<\/code> class represents a specific time zone and specifies the difference from UTC (Coordinated Universal Time). This allows accurate date and time information for different time zones.<\/p>\n3.1.1. Example Usage<\/h4>\nusing System;\n\nDateTimeOffset dateTimeOffset = DateTimeOffset.Now; \/\/ Current date and time\nConsole.WriteLine(dateTimeOffset); \/\/ Example: 2023-10-01 15:30:00 +09:00<\/code><\/pre>\n3.2. Using Date Picker<\/h3>\n
In UWP apps, DatePicker<\/code> and TimePicker<\/code> controls can be used to allow users to select dates and times. These two controls make it easy for the user interface to select dates and times.<\/p>\n3.2.1. Adding Date and Time Pickers via XAML<\/h4>\n
Here is the XAML code to add a DatePicker<\/code> and a TimePicker<\/code> to the UI:<\/p>\n<StackPanel>\n <TextBlock Text=\"Select Date:\" \/>\n <DatePicker x:Name=\"datePicker\" \/>\n\n <TextBlock Text=\"Select Time:\" \/>\n <TimePicker x:Name=\"timePicker\" \/>\n<\/StackPanel><\/code><\/pre>\n3.2.2. Handling Selected Date and Time<\/h4>\n
Here is an example of C# code for handling the selected date and time:<\/p>\n
using System;\nusing Windows.UI.Xaml;\nusing Windows.UI.Xaml.Controls;\n\n\/\/ Assume: datePicker and timePicker are defined in XAML\npublic MainPage()\n{\n this.InitializeComponent();\n datePicker.DateChanged += DatePicker_DateChanged;\n timePicker.TimeChanged += TimePicker_TimeChanged;\n}\n\nprivate void DatePicker_DateChanged(object sender, DatePickerValueChangedEventArgs e)\n{\n DateTime selectedDate = e.NewDateTime.Date;\n \/\/ Additional logic for the selected date\n}\n\nprivate void TimePicker_TimeChanged(object sender, TimePickerValueChangedEventArgs e)\n{\n TimeSpan selectedTime = e.NewTime;\n \/\/ Additional logic for the selected time\n}\n<\/code><\/pre>\n4. Manipulating Dates and Times<\/h2>\n
UWP offers various ways to quickly manipulate dates and times. Below, we will introduce methods for adding and subtracting date and time or comparing them.<\/p>\n
4.1. Adding Dates and Times<\/h3>\nusing System;\n\nDateTime today = DateTime.Now;\nDateTime nextWeek = today.AddDays(7); \/\/ One week later\nDateTime nextHour = today.AddHours(1); \/\/ One hour later<\/code><\/pre>\n4.2. Subtracting Dates and Times<\/h3>\nusing System;\n\nDateTime today = DateTime.Now;\nDateTime previousWeek = today.AddDays(-7); \/\/ One week ago\nDateTime previousHour = today.AddHours(-1); \/\/ One hour ago<\/code><\/pre>\n4.3. Comparing Dates and Times<\/h3>\nusing System;\n\nDateTime date1 = new DateTime(2023, 10, 1);\nDateTime date2 = new DateTime(2023, 10, 15);\n\nif (date1 < date2)\n{\n Console.WriteLine(\"date1 is earlier than date2.\");\n}\nelse if (date1 > date2)\n{\n Console.WriteLine(\"date1 is later than date2.\");\n}\nelse\n{\n Console.WriteLine(\"date1 and date2 are the same.\");\n}<\/code><\/pre>\n5. Formatting Dates and Times<\/h2>\n
UWP provides ways to represent dates and times in various formats. Users can specify formats as needed to provide easily readable date and time information.<\/p>\n
5.1. Default Format<\/h3>\nusing System;\n\nDateTime date = DateTime.Now;\nstring defaultFormat = date.ToString(); \/\/ Default format\nstring customFormat = date.ToString(\"dddd, dd MMMM yyyy\"); \/\/ Example: \"Saturday, 01 October 2023\"<\/code><\/pre>\n5.2. Culture-based Formatting<\/h3>\n
UWP supports date and time formats tailored to various cultures. You can use CultureInfo<\/code> to convert to a specific cultural format.<\/p>\nusing System.Globalization;\n\nCultureInfo cultureInfo = new CultureInfo(\"fr-FR\");\nstring frenchDate = date.ToString(cultureInfo); \/\/ Representing date in French format<\/code><\/pre>\n6. Example Project<\/h2>\n
Based on the above descriptions, let\u2019s create a simple example project. This project is an application that inputs dates and times and displays the selected date and time.<\/p>\n
6.1. XAML<\/h3>\n<Page x:Class=\"DateTimeApp.MainPage\">\n <Grid>\n <StackPanel>\n <TextBlock Text=\"Select Date:\" \/>\n <DatePicker x:Name=\"datePicker\" \/>\n\n <TextBlock Text=\"Select Time:\" \/>\n <TimePicker x:Name=\"timePicker\" \/>\n\n <Button Content=\"Show Info\" Click=\"ShowInfo_Click\" \/>\n\n <TextBlock x:Name=\"resultTextBlock\" \/>\n <\/StackPanel>\n <\/Grid>\n<\/Page><\/code><\/pre>\n6.2. C# Code<\/h3>\nusing Windows.UI.Xaml;\nusing Windows.UI.Xaml.Controls;\n\nnamespace DateTimeApp\n{\n public sealed partial class MainPage : Page\n {\n public MainPage()\n {\n this.InitializeComponent();\n }\n\n private void ShowInfo_Click(object sender, RoutedEventArgs e)\n {\n DateTime selectedDate = datePicker.DateTime.Date;\n TimeSpan selectedTime = timePicker.Time;\n\n string result = $\"Selected Date: {selectedDate.ToString(\"yyyy-MM-dd\")}\" +\n $\"\\nSelected Time: {selectedTime.Hours}:{selectedTime.Minutes}\";\n\n resultTextBlock.Text = result;\n }\n }\n}\n<\/code><\/pre>\n7. Conclusion<\/h2>\n