Module org.omnifaces

Package org.omnifaces.cdi.config

Class DateProducer

java.lang.Object

org.omnifaces.cdi.config.DateProducer

@Dependent
public class DateProducer
extends Object

Producer for #{startup} and #{now}.

Since 4.0 it produces by default an instance of Temporal whereas it previously produced an instance of Date.

Historical note: since 1.0 these were registered as beans in faces-config.xml. Since 3.6 these were migrated to CDI producers, because the CDI implementation being used may emit warnings on them not being proxyable.

Usage

• You can reference the application startup time as Temporal via #{startup} in EL.
• You can reference the current time as Temporal via #{now} in EL.
• They have a DateProducer.TemporalDate.getTime() method which allows you to obtain the epoch time via #{startup.time} and #{now.time} in EL.
• They have a DateProducer.TemporalDate.getInstant() method which allows you to convert them to Instant at ZoneOffset.UTC via #{startup.instant} and #{now.instant} in EL.
• They have a DateProducer.TemporalDate.getZonedDateTime() method which allows you to convert them to ZonedDateTime at ZoneId.systemDefault() via #{startup.zonedDateTime} and #{now.zonedDateTime} in EL.
• Since 4.7, they also have DateProducer.TemporalDate.getLocalDateTime(), DateProducer.TemporalDate.getLocalDate() and DateProducer.TemporalDate.getLocalTime() methods which allows you to convert them to LocalDateTime, LocalDate and LocalTime via #{startup.localDateTime}, #{now.localDateTime}, etc in EL.
• They are injectable in CDI beans via e.g. @Inject @Named private Temporal startup;.

Since:

3.6

Author:

Bauke Scholtz

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DateProducer.TemporalDate	ZonedDateTime is a final class, hence this proxy for CDI.

Constructor Summary

Constructors

Constructor	Description
DateProducer()

Method Summary

Modifier and Type	Method	Description
DateProducer.TemporalDate	getNow()	This makes an instance of Temporal as current datetime available by #{now}.
DateProducer.TemporalDate	getStartup()	This makes an instance of Temporal as startup datetime available by #{startup}.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DateProducer

public DateProducer()

Method Details

getStartup

@Produces
@Named
@ApplicationScoped
@Eager
public DateProducer.TemporalDate getStartup()

This makes an instance of Temporal as startup datetime available by #{startup}.

Returns:

Startup datetime.

getNow

@Produces
@Named
@RequestScoped
public DateProducer.TemporalDate getNow()

This makes an instance of Temporal as current datetime available by #{now}.

Returns:

Current datetime.