Qual è l'uso di "lenient"?

Question

Qui lenient viene utilizzato in Java DateFormat. Ho controllato il documento, ma non ho capito cosa stava dicendo.

Qualcuno può dirmi qual è l'uso di questo lenient, con un esempio in tempo reale in cui viene utilizzato?

Answer 1

È possibile impostare l'analizzatore di date come non troppo utile se si desidera che accetti rigorosamente un formato di data fornito. E 'ben spiegata in the doc:

Per default, l'analisi è clementi: Se l'ingresso non è nella forma usata dal metodo format di questo oggetto, ma può ancora essere analizzato come una data, quindi parse riesce. I clienti possono insistere sulla stretta osservanza del formato chiamando lo setLenient(false).

Answer 2

Per esempio, questo:

SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy"); 
System.out.println(simpleDateFormat.parse("0")); 
simpleDateFormat.setLenient(false); 
System.out.println(simpleDateFormat.parse("0")); 

risultati in:

Thu Jan 01 00:00:00 CET 1 
Exception in thread "main" java.text.ParseException: Unparseable date: "0" 
    at java.text.DateFormat.parse(Unknown Source) 
    at net.java.quickcheck.generator.support.X.main(X.java:28) 

Answer 3

Il javadoc afferma chiaramente:

Specificare se la data/ora di analisi è quello di essere indulgenti . Con l'analisi lenta di , il parser può utilizzare l'analisi euristica per interpretare gli input che non corrispondono esattamente al formato di questo oggetto. Con l'analisi rigorosa, gli input devono corrispondere al formato di questo oggetto.

Quindi, se si dispone di un modello e creare un oggetto Date che rigorosamente partite il vostro modello, impostare indulgente a false. Inoltre, DateFormat è indulgente, per impostazione predefinita.

In sostanza, DateFormat set Calendar.setLenient e gli stati Javadoc:

di specificare se l'interpretazione data/ora è di essere indulgente. Con un'interpretazione indulgente, una data come "Febbraio 942, 1996" sarà essere considerata equivalente al 941 ° giorno dopo il 1 febbraio 1996. Con un'interpretazione rigorosa (non indulgente), tali date causeranno un'eccezione a essere gettato. Il valore predefinito è clemente.

Answer 4

Se la data non è indulgente, genera un errore se si passa la data di intervallo ma se non lo è, accetta e lo risolve. ad esempio, August 61st dal commento precedente diventerà il 30 settembre. Java doc su come impostarlo. L'impostazione predefinita è vera.

Answer 5

L'oggetto DateFormat è moderato per impostazione predefinita.

Leniency (Javadoc - Calendario)

Calendar ha due modi per interpretare i campi del calendario, indulgente e non indulgente. Quando un calendario è in modalità lenta, accetta un intervallo di valori di campo del calendario più ampio di di quello che produce.Quando un calendario ricalcola i valori del campo del calendario per il reso da get(), tutti i campi del calendario vengono normalizzati. Ad esempio, un indulgente GregorianCalendar interpreta MESE == GENNAIO, DAY_OF_MONTH == 32 come 1 ° febbraio

Quando un calendario è in modalità non-indulgente, viene generata un'eccezione se c'è qualche incongruenza nei suoi campi del calendario . Ad esempio, un GregorianCalendar produce sempre valori DAY_OF_MONTH tra 1 e la durata del mese. Un GregorianCalendar non indulgente genera un'eccezione al momento del calcolo dei valori del proprio tempo o del campo del calendario se è stato impostato un valore di campo fuori intervallo .

Answer 6

Il mio consiglio è quello di passare sempre indulgenti. Non riesco a pensare a un caso in cui desideri essere clemente e questa impostazione non dovrebbe mai essere l'impostazione predefinita per classi come SimpleDateFormat. L'elaborazione privilegiata può interpretare i dati inutili come stringhe temporali valide e apre errori che potrebbero essere difficili da individuare nei test. Inoltre, se si sta usando indulgente per tollerare variazioni nel formato temporale, si brucerà. Per esempio:

System.out.println(new SimpleDateFormat("yyyyMMdd").parse("2010-12-30")); 

rendimenti questo (il fuso orario può variare):

Mon Nov 02 00:00:00 EST 2009 

Questo risultato assurdo sembra essere la meno un mese ("-1"), secondo giorno ("2- ") del 2010. Il mese di zeroth è dicembre!

Sfortunatamente, l'utilizzo di setLenient (false) non conduce a un'interpretazione rigorosa del pattern. SimpleDateFormat tollera spazzatura seguendo il pattern match, come discusso qui:

SimpleDateFormat.parse() ignores the number of characters in pattern

Inoltre, non è rigorosa circa il numero di caratteri del modello, come ad esempio "d" al posto di "dd":

SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/d"); 
sdf.setLenient(false); 
System.out.println("For 5: " + sdf.parse("2010/01/5")); 
System.out.println("For 05: " + sdf.parse("2010/01/05")); 
System.out.println("For 15: " + sdf.parse("2010/01/15")); 

Resa:

For 5: Tue Jan 05 00:00:00 EST 2010 
For 05: Tue Jan 05 00:00:00 EST 2010 
For 15: Fri Jan 15 00:00:00 EST 2010 

anche con setLenient (false) "2010/01/05" è accettato con il modello "MM/dd yyyy /". E il disaccordo sui dati viene ignorato, come "1999/2011" con lo schema "yyyy/aaaa" (la risposta è il 2011).

L'utilizzo di SimpleDateFormat per convalidare le stringhe di data/ora è purtroppo inaffidabile. Se segui il link sopra vedrai alcune soluzioni, inclusa una versione più severa di SimpleDateFormat scritta da me!

Answer 7

Il trattamento si riferisce all'applicazione o meno di una regola rigorosa all'analisi . Se un oggetto DateFormat è indulgente, accetta Jan 32, 2005. In effetti, ci vorrà la libertà di convertirlo in 1 febbraio 2006. Per impostazione predefinita, un oggetto DateFormat è indulgente.

import java.text.DateFormat; 
import java.text.ParseException; 
import java.util.Date; 

public class MainClass { 
    public static void main(String[] args) { 
    DateFormat shortDf = DateFormat.getDateInstance(DateFormat.SHORT); 

    DateFormat mediumDf = DateFormat.getDateInstance(DateFormat.MEDIUM); 
    DateFormat longDf = DateFormat.getDateInstance(DateFormat.LONG); 
    DateFormat fullDf = DateFormat.getDateInstance(DateFormat.FULL); 
    System.out.println(shortDf.format(new Date())); 
    System.out.println(mediumDf.format(new Date())); 
    System.out.println(longDf.format(new Date())); 
    System.out.println(fullDf.format(new Date())); 

    // parsing 
    try { 
     Date date = shortDf.parse("Jan 32, 2005"); 
    } catch (ParseException e) { 
    } 
    } 
} 

E il risultato:

1/26/07 
Jan 26, 2007 
January 26, 2007 
Friday, January 26, 2007