Différence entre Java DateUtils.plafond et DateUtils.tronquer

Il n'est pas clair dans la java doc quelle est la différence entre DateUtils.plafond et DateUtils.tronquer est. Est la java doc de mal? Quelqu'un peut-il me le confirmer?

plafond

public static Date de plafond(Date à date,
champ int)

Ceil cette date, laissant le champ spécifié comme étant le plus important domaine.

Par exemple, si vous aviez la date du 28 mars 2002 13:45:01.231, si vous
passé les HEURES, les il serait de retour le 28 Mar 2002 13:00:00.000. Si c'était
passé avec MOIS, il serait de retour le 1er mars 2002 0:00:00.000.

vs

tronquer

public static Date de tronquer(Date à date,
champ int)

Tronquer cette date, laissant le champ spécifié que la plupart des
terrain significatif.

Par exemple, si vous aviez la date du 28 mars 2002 13:45:01.231,
si vous avez passé des HEURES, il serait de retour le 28 Mar 2002 13:00:00.000.
Si cela a été adopté par MOIS, il serait de retour le 1er mars 2002 0:00:00.000.

Pour info, la méthode, le résultat est la valeur de retour, et le 'date' paramètre n'est pas modifié. La javadoc est ambigu sur ce point.

OriginalL'auteur cmcginty | 2012-05-14

  1. 7

    À ajouter sur Jim réponse, je pense qu'il y est une Javadoc erreur sur le plafond de la méthode. La description pour plafond(Date,int) a été mis à jour avec les 3.0 javadoc (à comparer à la 2.5 javadoc pour la même méthode)... et même si les autres n'étaient pas mis à jour, cette méthode utilise un code commun à la version du Calendrier... Ou à l'aide d'un simple test cas, vous pouvez voir qu'ils se comportent de la même (pour moi avec 3.1 au moins 🙂 )

    @Test
public void testCeil() {
    final Calendar date = new GregorianCalendar();
    date.clear();
    date.set(2002, 3, 28, 13, 45, 01);

    System.out.println(date.getTime());
    System.out.println(DateUtils.ceiling(date, Calendar.HOUR).getTime());
    System.out.println(DateUtils.ceiling(date.getTime(), Calendar.HOUR));
    System.out.println(DateUtils.truncate(date, Calendar.HOUR).getTime());
    System.out.println(DateUtils.truncate(date.getTime(), Calendar.HOUR));
    System.out.println(date.getTime());
}

    OriginalL'auteur Charlie

  2. 5

    La réponse est dans la documentation:

    Le tronquer, le plafond et le tour méthodes pourraient être considérés comme les Mathématiques.floor(), Math.ceil() ou les Mathématiques.le rond pour les dates de Cette façon, date-champs seront ignorés dans le fond.

    Qui je interpréter comme "Vous avez raison, mais il y a une raison"

    OriginalL'auteur Jim Barrows

  3. 3

    La documentation sur certaines versions antérieures de l'ceil() la méthode est MAUVAISE. Il a été corrigé à un certain point, et voici la documentation 3.1:

    public static Date ceiling(Date date,
                           int field)
Ceil this date, leaving the field specified as the most significant field.

For example, if you had the datetime of 28 Mar 2002 13:45:01.231, if you passed with HOUR, it would return 28 Mar 2002 14:00:00.000. If this was passed with MONTH, it would return 1 Apr 2002 0:00:00.000.

    Ainsi, alors que ceil() et trunc() à la fois de minimiser tous les champs restants (dans certains cas sets à 0, mais pour les fins de MOIS, il a donné le jour à 1), ceil() en fait incrémenter le champ que vous transmettez par 1, alors que le tronc ne sera pas.

    OriginalL'auteur Matt