finalmente java sabe trabalhar com data e hora

Habēmus Java 8Finalmente Java sabe trabalhar com datas e horários

Por que uma nova API?

public boolean isMesNatal(Calendar calendar){ return calendar.get(Calendar.MONTH) == 11;}

public boolean isMesNatal(Calendar calendar){ return calendar.get(Calendar.MONTH) == 11;}

Por que uma nova API?

Dezembro == 11

Por que uma nova API?

Calendar dataNascimento = Calendar.getInstance();dataNascimento.set(1983, Calendar.NOVEMBER, 15); Pessoa pessoa = new Pessoa(dataNascimento);

//Afirmação válidaassert pessoa.getDataNascimento() .get(Calendar.DAY_OF_MONTH) == 15;

Por que uma nova API?

Calendar dataNascimento = Calendar.getInstance();dataNascimento.set(1983, Calendar.NOVEMBER, 15); Pessoa pessoa = new Pessoa(dataNascimento);

pessoa.getDataNascimento().add(Calendar.DAY_OF_MONTH, 10);

//Afirmação inválidaassert pessoa.getDataNascimento() .get(Calendar.DAY_OF_MONTH) == 15;

Calendar é mutável

Por que uma nova API?

public class Pessoa{ private Calendar dataNascimento; // encapsulada

public Pessoa(Calendar dataNascimento){ this.dataNascimento = dataNascimento; } public Calendar getDataNascimento() { return (Calendar) this.dataNascimento.clone(); } }

Por que uma nova API?

long duracao = turno.getDuracao();// horas? minutos? milisegundos?

Por que uma nova API?

public class Turno { /** * @return duração de um turno de * trabalho em milisegundos */ public long getDuracao(){ … }}

Evolução1996 - java.util.Date (JDK 1.0)1997 - java.util.Calendar (JDK 1.1)2005 - Joda-Time (third library)2007 - JSR-310

JSR 310● Início oficial em 30/01/2007● Líderes

○ Stephen Colebourne○ Michael Nascimento Santos○ Roger Riggs

● Baseada fortemente no Joda Time○ http://blog.joda.org/2009/11/why-jsr-310-isn-joda-

time_4941.html

Date Time APIJDK 1.8

Princípios fundamentais

● Imutável● Modelo rico, compreensível e fluente● Separação de cronologias

Rico modelo de dadosExplorando alguns dos novos tipos de dados disponíveis

Datas● LocalDate

○ Datas consistêm em dia, mês e ano○ Data de nascimento, feriado, emissão de NF

LocalDate.of(2014, Month.MAY, 17);

Horas● LocalTime

○ Horários consitêm em hora, minutos e segundos○ Horário de início do expediente, horário do

despertador

LocalTime.of(13, 10);

Datas e horas● LocalDateTime

○ Composto por data e horas○ Data e hora de um atendimento médico, entrada de

log, marcação de ponto

LocalDateTime.of(2014, Month.MAY, 17, 13, 10);

Mais modelos● YearMonth

○ ano e mês de alistamento militar● MonthDay

○ mês e dia de nascimento● Year

○ ano de fabricação de um automóvel● Instant

○ um ponto na linha do tempo○ remete à classe j.u.Date

Mais modelos● DayOfWeek

○ enum com os dias da semana, SUNDAY, MONDAY..

● Month○ enum com os meses do ano JANUARY,

FEBRUARY● ZonedDateTime

○ Time-zones são tratadas separadamente○ Data e hora em um determinado time-zone

■ Remete à classe java.util.Calendar

● Projeto threeten-extra

A partir do Java 8 será muito importante a escolha correta do tipo de dado baseado na necessidade de cada aplicação.

Formatação e Parsing● LocalDate.now().format(...)● LocalDate.parse(...)

● Resolve o problema de thread-safety da API atual

Períodose durações● Period

○ Montante de tempo em termos de dias, meses e anos■ 2 anos, 5 meses e 7 dias

● Duration○ Montante de tempo em termos de tempo

■ 36 segundos■ 5 horas■ Porém suporta o conceito de dias com 24 horas

Adjusters● Usado para alterações complexas

○ ajustar uma data para o último dia do mês○ ajustar uma data para o proximo dia útil

public interface TemporalAdjuster { Temporal adjustInto(Temporal entrada);}

LocalDate dataAjustada = data.with(ultimoDiaDoMes());LocalDate dataAjustada = data.with(proximoDiaUtil());

Adjusters// 2000-10-15, domingoLocalDate date = LocalDate.of(2000, Month.OCTOBER, 15);

// primeiro dia do mês: 2000-10-01date.with(TemporalAdjusters.firstDayOfMonth());// Primeira segunda do mês: 2000-10-02date.with(TemporalAdjusters.firstInMonth( DayOfWeek.MONDAY));// último dia do mês: 2000-10-31date.with(TemporalAdjusters.lastDayOfMonth());

Adjusters// primeiro dia do próximo mês: 2000-11-01date.with(TemporalAdjusters.firstDayOfNextMonth());// primeiro dia do próximo ano: 2001-01-01date.with(TemporalAdjusters.firstDayOfNextYear());// primeiro dia do ano: 2000-01-01date.with(TemporalAdjusters.firstDayOfYear());

Testabilidade● Suporte a utilização j.t.Clock controlados

○ Mocks○ Fixos○ Timezones específicos

● Testes independentes de timezone● j.t.Clock pode ser injetado● Trabalhar com datas e horas ficou testável

Resumo● LocalDate 2014-05-17● LocalTime 15:29:33● LocalDateTime 2014-05-17T15:29:33● OffsetTime 15:29:33+01:00● OffsetDateTime 2014-05-17T15:29:33+01:00● ZonedDateTime 2014-05-17T15:29:33+01:00

America/Sao_Paulo● Year 2014● YearMonth 2014-05● MonthDay 05-17● Instant 2343545656.534 epoch-seconds

InteroperabilidadeInteragindo com a API antiga

java.util java.time

Date Instant

GregorianCalendar ZonedDateTime

TimeZone ZoneId e ZoneOffset

GregorianCalendar (data padrão 1970-01-01)

LocalTime

GregorianCalendar (hora padrão 00:00)

LocalDate

Interoperabilidade

Interoperabilidade● Calendar.toInstant()● GregorianCalendar.toZonedDateTime()● GregorianCalendar.from(ZonedDateTime)● Date.from(Instant)● Date.toInstant()● TimeZone.toZoneId()

JDBC e ORMInteragindo com o banco de dados

JDBC● JDBC no Java 8 suporta os novos tipos sem

mudanças na API pública● getObject e setObject

ANSI SQL Java SE 8

DATE LocalDate

TIME LocalTime

TIMESTAMP LocalDateTime

TIME WITH TIMEZONE OffsetTime

TIMESTAMP WITH TIMEZONE OffsetDateTime

JDBC

JPA● Ainda sem suporte oficial aos novos tipos

○ https://java.net/jira/browse/JPA_SPEC-63● Necessário criação de conversores

JPApublic class LocalDateConverter

implements AttributeConverter<LocalDate, Date> {

@Override public Date convertToDatabaseColumn(LocalDate ld) { ... }

@Override public LocalDate convertToEntityAttribute(Date d) { ... }}

JPA

@Overridepublic Date convertToDatabaseColumn(LocalDate ld) { if (ld == null) { return null; } return new Date(ld.getYear() - 1900,

ld.getMonthValue() - 1,

ld.getDayOfMonth());}

JPA

@Overridepublic LocalDate convertToEntityAttribute(Date d) { if (d == null) { return null; } return LocalDate.of(d.getYear() + 1900,

d.getMonth() + 1,

d.getDate());}

Backport● Suporte ao Java 7● Backport de funcionalidades

○ Qualidade de APIs muito superior○ Migração para Java 8 facilitada○ Não necessariamente de implementação

● threetenbp○ https://github.com/ThreeTen/threetenbp

Links● API e tutorial oficial

○ http://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html

○ http://docs.oracle.com/javase/tutorial/datetime/● Projeto threeten-extra

○ https://github.com/ThreeTen/threeten-extra● Demos e exemplos

○ https://github.com/mgraciano/tdc-2014

Obrigado@klausboeing@mgraciano