Unterschied zwischen Date-Klasse im Paket java.util & Paket java.sql

Diese Antworten scheinen teilweise veraltet.

Gerade lese ich ein wenig API-Code (Java-Version 1.8.0_91) und fand diese in java.sql.Date:

/**
 * Creates a date which corresponds to the day determined by the supplied
 * milliseconds time value {@code theDate}.
 *
 * @param theDate
 *            a time value in milliseconds since the epoch - January 1 1970
 *            00:00:00 GMT. The time value (hours, minutes, seconds,
 *            milliseconds) stored in the {@code Date} object is adjusted to
 *            correspond to 00:00:00 GMT on the day determined by the supplied
 *            time value.
 */
public Date(long theDate) {
    super(normalizeTime(theDate));
}

/*
 * Private method which normalizes a Time value, removing all low
 * significance digits corresponding to milliseconds, seconds, minutes and
 * hours, so that the returned Time value corresponds to 00:00:00 GMT on a
 * particular day.
 */
private static long normalizeTime(long theTime) {
    return theTime;
}

Die Methode für die Normalisierung der Zeit ist immer noch da und sogar der Kommentar sagt, dass die Zeit normiert auf 00:00:00 GMT aber es tut sich nix. Für einige Grund Sie entfernt die Normalisierung, das heißt, dass ein java.sql.Date enthält genau wie ein java.util.Date nur die Anzahl der Millisekunden seit dem 1.1.1970 gewertet. So gibt es eine zeitliche Komponente, aber es wird nicht angezeigt, extern.

Zum Beispiel der code

java.util.Date utilDate = new java.util.Date();
java.sql.Date sqlDate = new java.sql.Date(Calendar.getInstance().getTimeInMillis())

System.out.println(utilDate);
System.out.println(sqlDate);

erzeugt die Ausgabe

Thu Jun 02 13:17:35 CEST 2016
2016-06-02

Also seien Sie vorsichtig mit sql Daten und fassen Sie Sie nicht, wie Sie enthalten nur ein Datum und keine Zeit. Zum Beispiel:

java.sql.Date sqlDate1 = new java.sql.Date(Calendar.getInstance().getTimeInMillis());
java.sql.Date sqlDate2 = new java.sql.Date(Calendar.getInstance().getTimeInMillis());

System.out.println(sqlDate1);
System.out.println(sqlDate2);
System.out.println(sqlDate1.equals(sqlDate2));
System.out.println(sqlDate1.toString().equals(sqlDate2.toString()));

Drucke:

2016-06-02
2016-06-02
false
true

Die Alten

java.util.Date

Den java.util.Date Klasse Teil das alte Datum-Zeit-Klassen, die haben sich schlecht entwickelt, verwirrend und lästig. Die Absicht ist es, stellen ein moment (ein Datum und ein Uhrzeit-des-Tages -) auf der Zeitachse.

Die Klasse scheint einen moment in UTC, außer, dass seine toString Methode schweigend gilt die JVM die aktuelle Standard-Zeit-zone während der Erzeugung der Zeichenkette, die entsteht der Eindruck, dass eine java.util.Datum ist Zeit-zone, aber eigentlich nicht. Naja, eigentlich ist es hat haben Sie eine Zeitzone zugeordnet tief in seinen source code für irgendwas intern, aber nicht offensichtliche und nicht festgelegt noch get erreichbar. Ein verwirrendes Chaos.

java.sql.Date

Den java.sql.Date macht eine schlechte situation noch schlimmer durch die Darstellung der a nur-Datum-Wert (wie ist das gemeint "DATUM" in der SQL-Datenbank der Welt), aber Tat so als "hack" durch die Erweiterung java.util.Date. Aber das sollen Sie so tun, es ist nicht eine Unterklasse, wie Regie in der Klasse von doc. Darüber hinaus hat sich time-of-Tag, aber vorgibt, nicht zu indem Sie sich der erste moment des Tages, in UTC. Ein verwirrendes Chaos.

Und noch eins... die java.sql.Date - Klasse bietet auf einen Bruchteil der Sekunde mit einer Auflösung von Nanosekunden. Das geht über den Millisekunden Auflösung von java.util.Datum. Viele Datenbanken unterstützen feinere Auflösungen wie Mikrosekunde oder Nanosekunden.

So, in dieser alten Datum-Zeit-Klassen es gibt keinen Weg, um wirklich repräsentieren eine nur-Datum-Wert mit keine-Zeit-von-Tag noch die Zeit-zone.

Die Neue

Den java.Zeit framework kommt zur Rettung. Inspiriert von der sehr erfolgreichen Joda-Time Projekt. Erbaut in Java 8 und höher. Zurück portiert auf Java 6 & 7, und weitere angepasst an Android. Sehen Oracle Tutorial.

Instant

Den Instant Klasse repräsentiert einen moment auf der Zeitachse in UTC mit einer Auflösung von Nanosekunden. Klare und einfache.

Instant instant = Instant.now();

instant.toString() → 2016-06-19T02:34:55.564 Z

Wenn ein java.util.Date ist erforderlich für die Verwendung mit dem alten code, können Sie konvertieren. Finden Sie neue Methoden Hinzugefügt, um die alte Klasse: java.util.Datum::toInstant() und java.util.Datum.aus( Instant ).

Zonen

Anpassen, in einigen örtlichen Wand-Uhr-Zeit, gelten ein offset von UTC ( ZoneOffset ), um eine OffsetDateTime Objekt. Noch besser, wenn Sie wissen, die richtige Zeit-zone, name, gilt eine amp; zoneid zu bekommen ZonedDateTime.

Beispielsweise Amerika/Montreal ist vier Stunden hinter UTC im Sommer unter Daylight Saving Time (DST), so sehen wir, 10 PM (22:00) auf dem früheren Zeitpunkt in code unten anstatt 2 UHR in dem Beispiel oben. Zurück vier Stunden überquerte Mitternacht in der früheren Datum. Aber sowohl die instant Objekt ist oben und die zdt Objekt gesehen nächsten beide vertreten die gleichen gleichzeitiger moment auf der Zeitachse. Gleichen moment in der Geschichte, sondern "von morgen" in Paris, Kalkutta, und Auckland, während "gestern" in Montréal, Mexiko-Stadt und Honolulu.

ZoneId zoneId = ZoneId.of( "America/Montreal" );
ZonedDateTime zdt = ZonedDateTime.ofInstant( instant , zoneId );

zdt.toString() → 2016-06-18T22:34:55.564-04:00[Amerika/Montreal]

LocalDate

Für eine nur-Datum-Wert, verwenden Sie die LocalDate Klasse. Keine Zeit-von-Tag noch Zeit-zone beibehalten wird.

LocalDate localDate = zdt.toLocalDate();

Aber beachten Sie, dass eine Zeitzone ist entscheidend, ein Datum wie bei jedem gegebenen moment das Datum kann rund um den Globus variieren von time zone. Damit die Diskussion oben über die Angabe einer Zeitzone. Zum Beispiel, sehen Sie weiter, wie bekommen wir die 18 Juni statt der 19.

localDate.toString() → 2016-06-18

Wenn diese Unterscheidung zwischen Daten von time zone ist von Bedeutung, um Ihr Unternehmen, sollten Sie mit einem Datum-Zeit-Wert, gespeichert in einer Datenbank-Spalte-Typ des TIMESTAMP WITH TIME ZONE eher als DATE.

Suche Stack Overflow für viel mehr Informationen und viele Beispiele von java.Zeit (tag: java-time).

Datenbank

So speichern Sie die Datenbank, verwenden Sie eine JDBC Treiber Einhaltung JDBC 4.2 spec (siehe Guide). Rufen Sie setObject und getObject auf PreparedStatement direkt mit dem java.Zeit-Objekte.

Wenn Ihr JDBC-Treiber unterstützt noch keine solche direkte Nutzung von java.Zeit-Typen verwenden Sie die neue Methoden Hinzugefügt, um die alten Klassen zur Erleichterung der Umstellung. Aber minimieren Ihre Nutzung der alten Klassen; konvertieren in java.Zeit sofort und verwenden Sie nur java.Zeit, die Objekte in der business-Logik.

java.sql.Date mySqlDate = java.sql.Date.valueOf( localDate );

Und in die andere Richtung.

LocalDate localDate = mySqlDate.toLocalDate();