[threeten-dev] Clarification request: DateTimeFormatter.ofLocalizedDate/Time behavior

Masayoshi Okutsu masayoshi.okutsu at oracle.com
Mon Feb 4 21:06:57 PST 2013


On 2/5/2013 12:03 PM, Roger Riggs wrote:
> HI Masayoshi,
>
> On 02/04/2013 07:39 PM, Masayoshi Okutsu wrote:
>
>>
>> - Remove the following paragraph from 
>> DateTimeFormatterBuilder.appendLocalized(FormatStyle, FormatStyle).
>>
>>      * <p>
>>      * The pattern can vary by chronology, although typically it 
>> doesn't.
>>      * This method uses the standard ISO chronology patterns.
> This comment has already been modified to remove the reference to ISO.
> "     * <p>
>      * The pattern can vary by chronology, although typically it doesn't.
>      * This method allows the chronology to be specified.
> "
>
> Is that adequate or should the description be removed?

What does the paragraph mean? If it means to use the chronology from a 
Temporal in the actual formatting, it will be too hard for developers to 
understand.

Thanks,
Masayoshi

>
> Thanks, ROger
>
>
>>
>> There should be more documentation for the runtime behavior with 
>> localized formats, but it should be deferred to post-M7.
>>
>> Thanks,
>> Masayoshi
>>
>>
>> On 2/5/2013 8:45 AM, Stephen Colebourne wrote:
>>> On 4 February 2013 23:35, Masayoshi Okutsu 
>>> <masayoshi.okutsu at oracle.com> wrote:
>>>> ofLocalizedDate() invokes 
>>>> DTFormatterBuilder().appendLocalized(dateStyle,
>>>> null) which specifies the ISO Chronology as specified by 
>>>> appendLocalized.
>>>> Then, the ISO Chronology is always used when looking up a pattern.
>>>> withChronology doesn't change the Chronology. But neither ISO nor 
>>>> the given
>>>> Chronology by withChronology should be used for actual formatting?
>>>>
>>>> Looks like a structural problem in the API design rather than an
>>>> implementation problem? Or am I just confused?
>>> OK, I see the problem you refer to now.
>>>
>>> appendLocalized(FormatStyle dateStyle, FormatStyle timeStyle) is wrong
>>> and should use the chronology of the target temporal, which will be
>>> affected by withChronology().
>>>
>>> appendLocalized(FormatStyle dateStyle, FormatStyle timeStyle,
>>> Chronlogy chrono) should be deleted AFAICT.
>>>
>>> Stephen
>>
>



More information about the threeten-dev mailing list