From 4c7d65a8c8ea8d63bf3a653ed3dbce46251fb8bc Mon Sep 17 00:00:00 2001 From: Ben Stolovitz Date: Tue, 24 Jun 2025 11:57:41 -0400 Subject: [PATCH 1/4] Document basis for params for DateTimeFormatter --- .../datetimeformatter_datetimeformatter_1042679024.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md index 7c0c171a8..38907223f 100644 --- a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md +++ b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md @@ -25,21 +25,21 @@ The list of language identifiers, in priority order, that represent the choice o ### -param geographicRegion -The identifier for the geographic region. This identifier is used for resolving the template to a pattern. +The identifier for the geographic region. This identifier is used for resolving the template to a pattern. It should be a valid constructor for a [GeographicRegion](windows.globalization.geographicregion.md); in other words, one of the ISO 3166-1 two-letter or three-letter codes that identify the country, or one of the three-digit UN-M49 codes that identify the geographical region. ### -param calendar -The calendar identifier to use. +The calendar identifier to use. This should be one of the well-known [CalendarIdentifiers](windows.globalization.calendaridentifiers.md). ### -param clock -The clock identifier to use. +The clock identifier to use. This should be one of the well-known [ClockIdentifiers](windows.globalization.clockidentifiers.md). ## -remarks If your app passes language tags used in this class to any [National Language Support](/windows/desktop/Intl/national-language-support) functions, it must first convert the tags by calling [ResolveLocaleName](/windows/desktop/api/winnls/nf-winnls-resolvelocalename). -Language tags support the Unicode extensions "ca-" and "nu-". (See [Unicode Key/Type Definitions](https://www.unicode.org/reports/tr35/#Key_Type_Definitions).) Note that these extensions can affect the calendar used by Calendar objects. +Language tags support the Unicode extensions "ca-" and "nu-". (See [Unicode Key/Type Definitions](https://www.unicode.org/reports/tr35/#Key_Type_Definitions).) Note that these extensions can affect the calendar used by Clock objects. ## -examples From ff5212887c97bf78e4fe4d0759fe8d477ce93601 Mon Sep 17 00:00:00 2001 From: KB <12849639+Karl-Bridge-Microsoft@users.noreply.github.com> Date: Wed, 2 Jul 2025 15:17:51 -0700 Subject: [PATCH 2/4] Update datetimeformatter_datetimeformatter_1042679024.md refine --- .../datetimeformatter_datetimeformatter_1042679024.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md index 38907223f..f404de354 100644 --- a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md +++ b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md @@ -25,7 +25,7 @@ The list of language identifiers, in priority order, that represent the choice o ### -param geographicRegion -The identifier for the geographic region. This identifier is used for resolving the template to a pattern. It should be a valid constructor for a [GeographicRegion](windows.globalization.geographicregion.md); in other words, one of the ISO 3166-1 two-letter or three-letter codes that identify the country, or one of the three-digit UN-M49 codes that identify the geographical region. +The identifier for a [GeographicRegion](windows.globalization.geographicregion.md) used to resolve the template to a pattern. This should be an ISO 3166-1 two-letter or three-letter code that identifies the country, or one of the three-digit UN-M49 codes that identify the geographical region. ### -param calendar From d9dc0374826aed7220a79e1d68501abf75fea6d0 Mon Sep 17 00:00:00 2001 From: KB <12849639+Karl-Bridge-Microsoft@users.noreply.github.com> Date: Wed, 2 Jul 2025 15:29:24 -0700 Subject: [PATCH 3/4] Update datetimeformatter_datetimeformatter_1042679024.md refine --- .../datetimeformatter_datetimeformatter_1042679024.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md index f404de354..439d827c2 100644 --- a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md +++ b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md @@ -29,11 +29,11 @@ The identifier for a [GeographicRegion](windows.globalization.geographicregion.m ### -param calendar -The calendar identifier to use. This should be one of the well-known [CalendarIdentifiers](windows.globalization.calendaridentifiers.md). +The calendar identifier to use. This should be a value from [CalendarIdentifiers](windows.globalization.calendaridentifiers.md). ### -param clock -The clock identifier to use. This should be one of the well-known [ClockIdentifiers](windows.globalization.clockidentifiers.md). +The clock identifier to use. This should be a value from [ClockIdentifiers](windows.globalization.clockidentifiers.md). ## -remarks From bb0dd938b99882151a33d281f7a064a4317f7f26 Mon Sep 17 00:00:00 2001 From: Ben Stolovitz Date: Wed, 9 Jul 2025 13:31:32 -0400 Subject: [PATCH 4/4] Revert accidental change --- .../datetimeformatter_datetimeformatter_1042679024.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md index 439d827c2..d16e99cb9 100644 --- a/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md +++ b/windows.globalization.datetimeformatting/datetimeformatter_datetimeformatter_1042679024.md @@ -39,7 +39,7 @@ The clock identifier to use. This should be a value from [ClockIdentifiers](wind If your app passes language tags used in this class to any [National Language Support](/windows/desktop/Intl/national-language-support) functions, it must first convert the tags by calling [ResolveLocaleName](/windows/desktop/api/winnls/nf-winnls-resolvelocalename). -Language tags support the Unicode extensions "ca-" and "nu-". (See [Unicode Key/Type Definitions](https://www.unicode.org/reports/tr35/#Key_Type_Definitions).) Note that these extensions can affect the calendar used by Clock objects. +Language tags support the Unicode extensions "ca-" and "nu-". (See [Unicode Key/Type Definitions](https://www.unicode.org/reports/tr35/#Key_Type_Definitions).) Note that these extensions can affect the calendar used by Calendar objects. ## -examples