DateTimeFormatter  - AS3

Bu DateTimeFormatter nesnesi tarafından kullanılan gerçek yerel ayar kimliğinin adı.

İşletim sistemine ve Collator() yapıcısına iletilen requestedLocaleIDName parametresinin değerine bağlı olarak, ad değeri için üç olasılık vardır.

1. İstenen yerel ayar LocaleID.DEFAULT değilse ve işletim sistemi, istenen yerel ayar için destek sağlıyorsa, döndürülen ad, requestedLocaleIDName özelliğiyle aynı olacaktır.
2. LocaleID.DEFAULT, yapıcıya requestedLocaleIDName parametresinin değeri olarak kullanıldıysa, kullanıcının işletim sistemi tarafından belirtilen geçerli yerel ayarın adı kullanılır. LocaleID.DEFAULT değeri, OS'de kullanıcının özelleştirilmiş ayarını saklar. requestedLocaleIDName parametresi olarak açık bir değerin iletilmesi, iki yerel ayar kimliği aynı olsa da, LocaleID.DEFAULT kullanılmasıyla aynı sonucu vermeyebilir. Kullanıcı makinesinde yerel ayarları özelleştirmiş olabilir ve LocaleID.DEFAULT öğesini kullanmak yerine açık yerel ayar kimlik adı isteyerek uygulamanız bu özelleştirilmiş ayarları almaz.
3. Sistem, yapıcıda belirtilen requestedLocaleIDName öğesini desteklemiyorsa, bir geri dönüş yerel ayarı kimlik adı sağlanır.

İlgili API Öğeleri

Bu DateTimeFormatter nesnesinin gerçekleştirdiği önceki işlemin durumu. Bu sınıfın bir yapıcısı veya yöntemi her çağrıldığında ya da başka bir özellik ayarlandığında lastOperationStatus özelliği ayarlanır. Olası değerler için, her bir yöntemin açıklamasına bakın.

İlgili API Öğeleri

Bu DateTimeFormatter nesnesinin yapıcısına iletilmiş olan istenen yerel ayar kimliğinin adı.

LocaleID.DEFAULT değeri kullanıldıysa, döndürülen ad "i-default" olur. Geri dönüş yerel ayarı uygulandığında, gerçek yerel ayar, istenen yerel ayardan farklılık gösterebilir. Gerçek yerel ayarın adı, actualLocaleIDName özelliği kullanılarak alınabilir.

İlgili API Öğeleri

Tarih ve saatleri, belirtilen yerel ayarın kurallarına ve sağlanan tarih ve saat biçimlendirme stillerine göre biçimlendirmek için yeni bir DateTimeFormatter nesnesi oluşturur. Tarih ve saat stilleri, tarih ve saat biçimlendirme desenlerini önceden tanımlanmış, işletim sisteminin yerel ayarlarına bağlı desenlere ayarlamak için kullanılır.

Bu yapıcı, geçerli işletim sisteminin istenen yerel ayar kimliği adını destekleyip desteklemediğini belirler. Desteklenmiyorsa, bunun yerine geri dönüş yerel ayarı kullanılır. Geri dönüş yerel ayarının adı, actualLocaleIDName özelliğinden belirlenebilir.

requestedLocaleIDName, dateStyle veya timeStyle parametrelerinin herhangi biri için geri dönüş kullanılırsa, lastOperationStatus özelliği, geri dönüş türüne ayarlanır.

Kullanıcının geçerli işletim sistemi tercihlerine bağlı olarak biçimlendirmek için, yapıcıya requestedLocaleIDName parametresinde LocaleID.DEFAULT değerini iletin.

Yapıcı çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

İstenen yerel ayar kimlik adı kullanılamıyorsa, lastOperationStatus öğesi şu değerlerden birine ayarlanır:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Yukarıda listelenen uyarılar ve lastOperationStatus özelliğinin diğer olası değerleri hakkında ayrıntılı bilgi için, LastOperationStatus sınıfındaki açıklamalara bakın.

İlgili API Öğeleri

Kullanıcının yerel saati olarak yorumlanan bir Date nesnesinin görüntüleme dizesini biçimlendirir (Date nesnesinin yerel saat bileşenlerini kullanarak, örn: date, day, fullYear, hours, minutes, month ve seconds). Biçimlendirme, belirtilen yerel ayar kimliği kuralları ve tarih stili ve saat stili veya bu DateTimeFormatter örneği için özelleştirilmiş tarih deseni ve saat deseni kullanılarak gerçekleştirilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

UTC saati olarak yorumlanan bir Date nesnesinin görüntüleme dizesini, dateStyle, timeStyle veya date saat desenine göre biçimlendirir (Date nesnesinin UTC bileşenlerini kullanarak, örn: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC ve secondsUTC). Biçimlendirme, belirtilen yerel ayar kimliği kuralları ve tarih stili ve saat stili veya bu DateTimeFormatter örneği için özelleştirilmiş tarih deseni ve saat deseni kullanılarak gerçekleştirilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bu sınıf tarafından desteklenen tüm yerel ayar kimlik adlarını listeler.

Bu sınıf geçerli işletim sisteminde desteklenmiyorsa, bu yöntem null değerini döndürür.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

DateTimeFormatter öğesinin bu örneği için tarih stilini alır. İşletim sisteminden önceden tanımlanmış bir tarih biçimlendirmesini almak için veri stili kullanılır. Tarih stili değeri, DateTimeFormatter() yapıcısı, setDateTimeStyles() yöntemi veya setDateTimePattern() yöntemi tarafından ayarlanabilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

Tarihleri ve saatleri biçimlendirmek için bu DateTimeFormatter nesnesi tarafından kullanılan desen dizesini döndürür.

Bu desen üç yöntemden biri kullanılarak ayarlanabilir:

1. Yapıcıda kullanılan dateStyle ve timeStyle parametreleri tarafından
2. setDateTimeStyles() yöntemi tarafından
3. setDateTimePattern() yöntemi tarafından.

Desen sözdiziminin açıklaması için, setDateTimePattern() yöntemine bakın.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

Bu yerel ayar ve takvim sistemi için haftanın ilk gününe karşılık gelen bir tam sayı döndürür. 0 değeri Pazar'a, 1 değeri Pazartesi'ye, vb. karşılık gelir ve son olarak 6 değeri de Cumartesi'ye karşılık gelir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

Geçerli takvim sistemi için ay adlarını içeren yerelleştirilmiş dizelerin bir listesini alır. Listedeki birinci öğe, yılın ilk ayının adıdır.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

DateTimeFormatter öğesinin bu örneği için saat stilini alır. İşletim sisteminden önceden tanımlanmış bir saat biçimlendirmesini almak için saat stili kullanılır. Saat stili değeri, DateTimeFormatter() yapıcısı, setDateTimeStyles() yöntemi veya setDateTimePattern() yöntemi tarafından ayarlanabilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

Geçerli takvim sistemi için haftanın günlerinin adlarını içeren yerelleştirilmiş dizelerin bir listesini alır. Listedeki birinci öğe, Pazar gününün adını temsil eder.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Tarihleri ve saatleri biçimlendirmek için bu DateTimeFormatter nesnesi tarafından kullanılan desen dizesini ayarlar.

Tarihleri biçimlendirmek için kullanılan desen, üç yöntemden biri kullanılarak ayarlanabilir:

1. Yapıcıda kullanılan dateStyle ve timeStyle parametreleri tarafından
2. setDateTimeStyles() yöntemi tarafından
3. Bu setDateTimePattern() yöntemi tarafından.

Bu yöntemin yan etkisi, bu DateTimeFormatter nesnesinin geçerli saat ve tarih stillerini geçersiz kılıp DateTimeStyle.CUSTOM değerine ayarlamasıdır.

Tarih ve saatlerin nasıl biçimlendirildiğini tanımlayan bir desen stili. Desen, yerine biçimlendirilen dizedeki tarih ve saat değerlerinin geleceği harfler sırasından oluşur. Örneğin, "yyyy/MM" deseninde, "yyyy" karakterlerinin yerine dört basamaklı yıl gelir, ardından "/" karakteri koyulur ve "MM" karakterlerinin yerine de iki basamaklı ay gelir.

Aşağıdaki tabloda açıklandığı gibi, farklı çıktılar üretmek için, desenlerde kullanılan çoğu harf birçok defa yinelenebilir.

Bir sıra, desen tarafından desteklenen maksimum harf sayısını aşarsa, o desen harfi için desteklenen en uzun sıraya eşlenir. Örneğin:

• MMMMMM, MMMM ile değiştirilir
• dddd, dd ile değiştirilir
• EEEEEEE, EEEE ile değiştirilir
• aa, a ile değiştirilir
• hhh, hh ile değiştirilir
• mmmm, mm ile değiştirilir

Teorik olarak bir desen en fazla 255 karakter içerebilir ancak bazı platformların daha katı bir sınırı vardır. Desen, desen karakteri sınırını aşarsa, lastOperationStatus özelliği, LastOperationStatus.PATTERN_SYNTAX_ERROR değerine ayarlanır.

Tüm olası desenler her işletim sisteminde desteklenmez. Bir desen platformda desteklenmiyorsa, geri dönüş deseni kullanılır ve lastOperationStatus özelliği geri dönüş kullanıldığını belirtmek için ayarlanır. Makul bir geri dönüş deseni sağlanamıyorsa, boş bir dize kullanılır ve lastOperationStatus özelliği, desenin desteklenmediğini belirtmek için ayarlanır.

Aşağıdaki tablo, geçerli desen harflerini ve bunların anlamını açıklar.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

DateTimeFormatter öğesinin bu örneği için tarih ve saat stillerini ayarlar. Tarih ve saat stilleri, tarih ve saat biçimlendirme desenlerini önceden tanımlanmış, işletim sisteminin yerel ayarlarına bağlı desenlere ayarlamak için kullanılır. Bu yöntem, DateTimeFormatter() yapıcı kullanılarak veya setDateTimePattern() yöntemi kullanılarak oluşturulan stilleri değiştirir. Ayrıca tarih ve saat deseni, ayarlanan stillere göre güncellenir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bu örnek şu yerel ayarları kullanmaktadır: İngilizce (ABD), Fransızca (Fransa), İspanyolca (İspanya).

Aşağıdaki örnek listedeki her yerel ayar için aşağıdakileri yapar:

1. Varsayılan stili (uzun dateStyle, uzun timeStyle) kullanarak bir DateTimeFormatter nesnesi oluşturur.
2. Geçerli tarih ve saati varsayılan uzun tarih stilini kullanarak biçimlendirir.
3. DateTimeStyle.NONE ve DateTimeStyle.SHORT sabitlerini kullanarak yalnızca saat kısa tarih stiline geçin.
4. Geçerli tarih ve saati yalnızca saat kısa tarih stilini kullanarak biçimlendirir.

package {
    import flash.display.Sprite;
    import flash.globalization.DateTimeFormatter;
    import flash.globalization.DateTimeStyle;
    
    public class DateTimeFormatterExample extends Sprite
    {    
        private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
    
        public function DateTimeFormatterExample()
        {
            var date:Date = new Date();
            
            for each (var locale:String in localeList) {
                var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
                trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName 
                    + "; actual=" + dtf.actualLocaleIDName);
            
                var longDate:String = dtf.format(date);
                trace(longDate + " (" + dtf.getDateTimePattern() + ")");
            
                dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
                var shortDate:String = dtf.format(date);
                trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
            }        
        }
    }
}

Aşağıdaki örnek listedeki her yerel ayar için aşağıdakileri yapar:

1. Üç girdi ve çıktı metni alanı oluşturur.
2. Amerikan İngilizcesi yerel ayarını kullanarak bir DateTimeFormatter nesnesi oluşturur.
3. Metin alanlarının konumunu ve boyutunu ayarlayan ve patternField nesnesine bir olay dinleyicisi ekleyen configureTextField() işlevini çağırır.
4. Kullanıcı patternField metin alanına deseni girdiğinde, textInputHandler işlevi deseni kullanarak geçerli tarih ve saati biçimlendirir ve çıktı metni alanlarında sonucu ve lastOperationStatus değerini görüntüler.

 
package {  
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.globalization.DateTimeFormatter;
    import flash.text.*;
    
    public class DateTimePatternExample extends Sprite
    {    
        private var patternField:TextField = new TextField();
        private var resultField:TextField = new TextField();
        private var statusField:TextField = new TextField();
           private var date:Date = new Date();
         private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");           
         
        private function configureTextField():void
        {
            patternField.type = TextFieldType.INPUT;
            patternField.width = 300;
            patternField.height = 20;
            patternField.background = true;
            patternField.border = true;
            
            resultField.y = 40;
            resultField.width = 300;
            resultField.height = 20;
            
            statusField.y = 80;
            statusField.width = 300;
            statusField.height = 20;

            addChild(patternField);
            addChild(resultField);
            addChild(statusField);
            patternField.addEventListener(Event.CHANGE,textInputHandler);
        }

        private function textInputHandler(event:Event):void
        {                 
            dtf.setDateTimePattern(patternField.text);
            statusField.text = dtf.lastOperationStatus;
            resultField.text = dtf.format(date);
        }

        public function DateTimePatternExample()
        {
            configureTextField();    
        }
    }
}