یادداشت های عمومی در مورد الگوهای محبوب

SimpleDateFormat is a concrete class for formatting and parsing dates in a locale-sensitive manner. It allows for formatting (date -> text), parsing (text ->تاریخ) ، و عادی سازی.

SimpleDateFormat به شما امکان می دهد با انتخاب هرگونه الگوی تعریف شده توسط کاربر برای قالب بندی تاریخ ، شروع کنید. با این حال ، شما را تشویق می کنید تا یک فرم ساز با تاریخ با GetTimeInstance ، GetDateInstance یا GetDatetimeInstance در DateFormat ایجاد کنید. هر یک از این روشهای کلاس می توانند یک قالب تاریخ/زمان را با الگوی فرمت پیش فرض بازگردانند. شما می توانید الگوی قالب را با استفاده از روش های ApplyPatte مطابق دلخواه تغییر دهید. برای اطلاعات بیشتر در مورد استفاده از این روش ها ، به DateFormat مراجعه کنید.

الگوهای تاریخ و زمان

قالب های تاریخ و زمان توسط رشته های الگوی تاریخ و زمان مشخص می شوند. در طول رشته های الگوی تاریخ و زمان ، نامه های ناشناخته از "A" به "z" و از "A" به "z" به عنوان نامه های الگوی نمایانگر اجزای یک رشته تاریخ یا زمان تعبیر می شوند. برای جلوگیری از تفسیر ، متن را می توان با استفاده از نقل قول های منفرد (') نقل کرد."" "نمایانگر یک نقل قول واحد است. همه شخصیت های دیگر تفسیر نمی شوند. آنها به سادگی در هنگام قالب بندی در رشته خروجی کپی می شوند یا در هنگام تجزیه در برابر رشته ورودی مطابقت دارند.

نامه های الگوی زیر تعریف شده است (تمام شخصیت های دیگر از "A" به "Z" و از "A" به "Z" محفوظ هستند):

• متن: برای قالب بندی ، اگر تعداد حروف الگوی 4 یا بیشتر باشد ، از فرم کامل استفاده می شود. در غیر این صورت در صورت وجود از یک فرم کوتاه یا مختصر استفاده می شود. برای تجزیه ، هر دو شکل پذیرفته شده اند ، مستقل از تعداد حروف الگوی.

   

• برای قالب بندی ، اگر تعداد حروف الگوی 2 باشد ، سال به 2 رقم کوتاه می شود. در غیر این صورت به عنوان یک عدد تعبیر می شود.
• برای تجزیه ، اگر تعداد حروف الگوی بیش از 2 باشد ، سال بدون در نظر گرفتن تعداد ارقام ، سال به معنای واقعی کلمه تفسیر می شود. بنابراین با استفاده از الگوی "mm/dd/yyyy" ، "01/11/12" تا 11 ژانویه ، 12 A. D.
• برای تجزیه با الگوی سالانه مخفف ("Y" یا "YY") ، SimpleDateFormat باید سال مختصر را نسبت به برخی از قرن ها تفسیر کند. این کار را با تنظیم تاریخ ها طی 80 سال قبل و 20 سال پس از زمان ایجاد نمونه SimpleDateFormat انجام می دهد. به عنوان مثال ، با استفاده از الگویی از "MM/DD/YY" و یک نمونه SimpleDateFormat که در 1 ژانویه 1997 ایجاد شده است ، رشته "01/11/12" به عنوان 11 ژانویه 2012 در حالی که رشته "05/04/تفسیر می شود64 "به عنوان 4 مه 1964 تفسیر می شود. در طول تجزیه ، فقط رشته هایی که دقیقاً از دو رقم تشکیل شده اند ، همانطور که توسط شخصیت تعریف شده است. isdigit (char) ، در قرن پیش فرض تجزیه می شوند. هر رشته عددی دیگر ، مانند یک رشته یک رقمی ، یک رشته سه یا چند رقمی یا یک رشته دو رقمی که همه رقم نیست (برای مثال "-1") ، به معنای واقعی کلمه تفسیر می شود. بنابراین "01/02/3" یا "01/02/003" با استفاده از همان الگوی ، مانند 2 ژانویه ، 3 میلادی تجزیه می شوند. به همین ترتیب ، "01/02/-3" به عنوان 2 ژانویه 4 قبل از میلاد تجزیه می شود.

اگر هفته هفته "Y" مشخص شود و تقویم از هر هفته پشتیبانی نمی کند ، به جای آن از سال تقویم ("Y") استفاده می شود. پشتیبانی از سالهای هفته را می توان با تماس با GetCalendar () آزمایش کرد. isweekdatesupported ().

برای تجزیه ، مناطق زمانی RFC 822 نیز پذیرفته شده است.

برای قالب بندی ، اگر مقدار جبران GMT 0 باشد ، "z" تولید می شود. اگر تعداد حروف الگوی 1 باشد ، هر کسری از یک ساعت نادیده گرفته می شود. به عنوان مثال ، اگر الگوی "x" باشد و منطقه زمانی "GMT+05: 30" باشد ، "+05" تولید می شود.

برای تجزیه ، "Z" به عنوان طراح منطقه زمانی UTC تجزیه می شود. مناطق زمانی عمومی پذیرفته نمی شوند.

مثال ها

مثالهای زیر نشان می دهد که چگونه الگوهای تاریخ و زمان در محلی ایالات متحده تفسیر می شود. تاریخ و زمان معین 2001-07-04 12:08:56 به وقت محلی در منطقه زمانی زمان اقیانوس آرام ایالات متحده.

هماهنگ سازی

قالب های تاریخ هماهنگ نیستند. توصیه می شود برای هر موضوع نمونه های با فرمت جداگانه ایجاد کنید. اگر چندین موضوع به طور همزمان به یک فرمت دسترسی پیدا کنند ، باید در خارج هماهنگ شود.

خلاصه کلاس تو در تو

کلاس ها/رابط های تو در تو به ارث رفته از کلاس java. text. dateformat

خلاصه میدانی

زمینه های ارثی از کلاس java. text. dateformat

خلاصه سازنده

با استفاده از نمادهای الگوی پیش فرض و نمادهای قالب تاریخ برای محلی پیش فرض ، یک SimpleDateFormat ایجاد می کند.

با استفاده از الگوی داده شده و نمادهای قالب پیش فرض تاریخ برای محلی پیش فرض ، یک SimpleDateFormat ایجاد می کند.

با استفاده از الگوی داده شده و نمادهای فرمت تاریخ پیش فرض برای محل داده شده ، یک SimpleDateFormat ایجاد می کند.

خلاصه روش

مواد و روش ها

سالهای دو رقمی دوره 100 ساله را برای شروع در تاریخ مشخص شده کاربر تعبیر می کند.

روشهای ارثی از کلاس java. text. dateformat

روشهای ارثی از کلاس java. text. format

روشهای ارثی از کلاس java. lang. object

جزئیات سازنده

ساده

با استفاده از نمادهای الگوی پیش فرض و نمادهای قالب تاریخ برای محلی پیش فرض ، یک SimpleDateFormat ایجاد می کند. توجه: این سازنده ممکن است از همه مناطق پشتیبانی نکند. برای پوشش کامل ، از روش های کارخانه در کلاس DateFormat استفاده کنید.

ساده

با استفاده از الگوی داده شده و نمادهای قالب پیش فرض تاریخ برای محلی پیش فرض ، یک SimpleDateFormat ایجاد می کند. توجه: این سازنده ممکن است از همه مناطق پشتیبانی نکند. برای پوشش کامل ، از روش های کارخانه در کلاس DateFormat استفاده کنید.

ساده

با استفاده از الگوی داده شده و نمادهای فرمت تاریخ پیش فرض برای محل داده شده ، یک SimpleDateFormat ایجاد می کند. توجه: این سازنده ممکن است از همه مناطق پشتیبانی نکند. برای پوشش کامل ، از روش های کارخانه در کلاس DateFormat استفاده کنید.

ساده

جزئیات روش

set2digityearstart

سالهای دو رقمی دوره 100 ساله را برای شروع در تاریخ مشخص شده کاربر تعبیر می کند.

get2digityearstart

قالب

فرماتوکراکتور ساز

فرمت های یک شیء تولید کننده انتساب. می توانید برای ساخت رشته حاصل و همچنین برای تعیین اطلاعات در مورد رشته حاصل از آن استفاده کنید.

هر کلید ویژگی از atributeDcharacteriteritor از نوع dateformat. field خواهد بود ، با مقدار ویژگی مربوطه همان کلید ویژگی است.

تجزیه کردن

این روش سعی دارد متن را از شاخص داده شده توسط POS شروع کند. اگر تجزیه و تحلیل موفق شود ، پس از آخرین کاراکتر مورد استفاده ، شاخص POS به فهرست به روز می شود (تجزیه لزوماً از تمام شخصیت ها تا انتهای رشته استفاده نمی کند) و تاریخ تجزیه شده بازگردانده می شود. از POS به روز شده می توان برای نشان دادن نقطه شروع برای تماس بعدی به این روش استفاده کرد. اگر خطایی رخ دهد ، سپس شاخص POS تغییر نمی کند ، شاخص خطای POS روی شاخص کاراکتر که در آن خطا رخ داده است تنظیم می شود و تهی بازگردانده می شود.

این عمل تجزیه و تحلیل از تقویم برای تولید تاریخ استفاده می کند. تمام قسمتهای تاریخ تقویم قبل از تجزیه و تحلیل پاک می شوند و مقادیر پیش فرض تقویم در زمینه های تاریخ برای هرگونه اطلاعات تاریخ از دست رفته استفاده می شود. به عنوان مثال ، ارزش سال تاریخ تجزیه شده در سال 1970 با GregorianCalendar در صورت عدم ارزش یک سال از عملیات تجزیه نیست. بسته به الگوی داده شده و مقدار منطقه زمانی در متن ، ممکن است مقدار منطقه زمانی رونویسی شود. هر مقدار منطقه زمانی که قبلاً با فراخوانی برای SettimeZone تعیین شده بود ، ممکن است برای عملیات بیشتر احیا شود.