تغییرات پردازش تاریخ از زمان ارائه‌ی ASP.NET Core 3.1
از زمان ارائه‌ی
کتابخانه‌ی JSON توکار در ASP.NET Core 3x، نحوه‌ی پردازش تاریخ‌های دریافتی در برنامه‌های ASP.NET Core نیز تغییر کرد و در حالت دریافت اطلاعات به صورت JSON در اکشن متدها، فقط بر اساس ISO 8601-1:2019 عمل میکند. یعنی اگر تاریخ را با فرمت متداول 2019/06/14 به سمت سرور ارسال کنید، خطای ModelState زیر را دریافت خواهید کرد:
{
"$.time": [
"The JSON value could not be converted to System.DateTime. Path: $.time | LineNumber: 1 | BytePositionInLine: 23."
]
}
که عنوان میکند تاریخ ارسالی قابل پردازش نیست. چون فرمت دریافتی آن باید به این صورت باشد:
2019-06-14T02:30:04.0576719Z
و در کل
این فرمت‌ها را قبول میکند:
'Full date'
"yyyy'-'MM'-'dd"
"'Full date''T''Hour'':''Minute'"
"yyyy'-'MM'-'dd'T'HH':'mm"
"'Full date''T''Partial time'"
"yyyy'-'MM'-'dd'T'HH':'mm':'ss" (The Sortable ("s") Format Specifier)
"yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'FFFFFFF"
"'Full date''T''Time hour'':''Minute''Time offset'"
"yyyy'-'MM'-'dd'T'HH':'mmZ"
"yyyy'-'MM'-'dd'T'HH':'mm('+'/'-')HH':'mm"
'Date time'
"yyyy'-'MM'-'dd'T'HH':'mm':'ssZ"
"yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'FFFFFFFZ"
"yyyy'-'MM'-'dd'T'HH':'mm':'ss('+'/'-')HH':'mm"
"yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'FFFFFFF('+'/'-')HH':'mm" تغییرات پردازش تاریخ در ASP.NET Core 5x
در نگارش‌های قبلی ASP.NET Core، اگر تاریخی از طریق کوئری استرینگ و با فرمت ISO فوق دریافت می‌شد، مانند:
https://localhost:44393/time?time=2019-06-14T02:30:04.0576719Z
زمانیکه در سمت سرور پردازش می‌شد، نوع آن به اشتباه به Local ترجمه می‌شد و UTC آن درنظر گرفته نمی‌شد:
Model-bound value is: 2019-06-13T19:30:04.0576719-07:00, Kind is: Local
این مشکل در ASP.NET Core 5x
برطرف شده‌است و اینبار Kind تاریخ پردازش شده، از نوع UTC ارسالی است.
یک نکته: ویژگی‌های BindProperty و DisplayFormat در razor pages، امکان تغییر فرمت ورودی و نمایشی را می‌دهند:
[BindProperty, DisplayFormat(DataFormatString = "{0:yyyy-MM-ddTHH:mm}", ApplyFormatInEditMode = true)]
public DateTime DateTime { get; set; }
DateTime: <input asp-for="DateTime" asp-format="{0:yyyy-MM-ddTHH:mm}" /> 
