Java SE 8 will ship with a new date and time API in java. The new API models the domain well, with a good selection of classes for modeling a wide variety of developer use cases. Date d new Date(); " d); To find out what day corresponds to a particular date: Date d new Date(63, 0, 16); January 16, 1963 of the week: " d. Day()); The date can be set and examined according to the local time zone into the year, month, day, hour, minute and second. DateFormat 1108 @see 1109 @see 1110 @deprecated As of JDK version 1. GMT TimeZone. 1113 1114 @Deprecated 1115 public. Constructs a Date object using the given milliseconds time value. If the given milliseconds value contains time information, the driver will set the time components to the time in the default time zone (the time zone of the Java virtual machine running the application) that corresponds to zero GMT. So in this scenario you cannot automatically get the creation time of your file for javadoc. What I'd suggest is that you define a template for new files in your IDE which inserts on creation the actual time as a part of the file's javadoc and that is not changed later. The doc comments for the Java platform API specification is owned programmers. However, they are edited by both programmers and writers. It is a basic premise that writers and programmers honor each other's capabilities and both contribute to the best doc comments possible. Date extends Date. To conform with the definition of SQL DATE, the millisecond values wrapped by a java. Date instance must be 'normalized' by setting the hours, minutes, seconds, and milliseconds to zero in the particular time zone with which the instance is associated.