Package org.hibernate.annotations

Annotation Interface CurrentTimestamp

@Retention(RUNTIME)
@Target({FIELD,METHOD,ANNOTATION_TYPE})
public @interface CurrentTimestamp

Specifies that the annotated field of property is a generated timestamp, and also specifies the timing of the timestamp generation, and whether it is generated in Java or by the database:

• source = VM indicates that the virtual machine current instant is used, and
• source = DB indicates that the database current_timestamp function should be used.

By default, the timestamp is generated by the database, which requires an extra round trip to the database to fetch the generated value.

This annotation may be used in combination with the JPA-defined Version annotation.

The annotated property may be of any one of the following types: Date, Calendar, Date, Time, Timestamp, Instant, LocalDate, LocalDateTime, LocalTime, MonthDay, OffsetDateTime, OffsetTime, Year, YearMonth, or ZonedDateTime.

Since:

6.0

See Also:

• UpdateTimestamp
• CreationTimestamp
• CurrentTimestampGeneration

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
EventType[]	event	Determines when the timestamp is generated.
SourceType	source	Specifies how the timestamp is generated.
@Remove GenerationTiming	timing	Deprecated. This was introduced in error

Element Details

event

EventType[] event

Determines when the timestamp is generated. But default, it is updated when any SQL insert or update statement is executed. If it should be generated just once, on the initial SQL insert, explicitly specify event = INSERT.

Default:

{INSERT, UPDATE}

timing

@Deprecated(since="6.2")
@Remove
@Remove GenerationTiming timing

Deprecated.

This was introduced in error

Determines when the timestamp is generated. But default, it is updated when any SQL insert or update statement is executed. If it should be generated just once, on the initial SQL insert, explicitly specify timing = INSERT.

Default:

ALWAYS

source

SourceType source

Specifies how the timestamp is generated. By default, it is generated by the database, and fetched using a subsequent select statement.

Default:

DB