Visão geral
Os tipos de dados da coluna DataTable date
e datetime
usam a classe de data JavaScript integrada.
Importante: em objetos Date JavaScript, os meses são indexados a partir de zero e vão até onze, com janeiro sendo mês 0 e dezembro sendo mês 11.
Datas e horários usando o construtor de datas
Datas usando o construtor de datas
Para criar um novo objeto Date, chame o construtor Date()
com a palavra-chave new
, com argumentos para especificar componentes da data. Esses argumentos
têm a forma de vários números correspondentes às diferentes propriedades da sua data.
new Date(Year, Month, Day, Hours, Minutes, Seconds, Milliseconds)
Ao usar o construtor de data com o tipo de dados date
, você só precisa especificar o ano, o mês e o dia.
O construtor "Date" também pode ter a forma new Date(Milliseconds)
, em que
"Milliseconds" é a distância em milissegundos da data desejada desde
1o de janeiro de 1970 00:00:00 UTC. Para datas e horários anteriores a essa data, será fornecido um número negativo de milissegundos.
Usar o construtor de data é útil na construção manual da sua tabela de dados usando os métodos addColumn()
, addRow()
e addRows()
, bem como o método arrayToDataTable()
. No entanto, se você usar JSON para especificar dados, a representação de string precisará ser usada.
O construtor JavaScript Date também pode aceitar uma representação de string da data como argumento. Essa string pode assumir várias formas diferentes. Os formulários mais confiáveis estão em conformidade com a especificação RFC 2822 ou a especificação ISO 8601. Os formatos são os seguintes:
-
RFC 2822:
'MMM DD, YYYY'
ou'DD MMM, YYYY'
(exemplo:new Date('Jan 1, 2015')
ounew Date('1 Jan, 2015')
) -
ISO 8601 —
'YYYY-MM-DD'
(Exemplo:new Date('2015-01-01')
)
Aviso:a representação de string no construtor "Date" pode ser analisada de forma diferente por navegadores e versões de navegadores diferentes, retornando datas diferentes para a mesma string. Por isso, não é recomendado transmitir strings para o construtor Date. Em vez disso, recomendamos usar apenas números para os argumentos do construtor "Date".
O cronograma abaixo mostra o campeão do Super Bowl de cada temporada da NFL desde 2000.
Veja abaixo o código para criar esse cronograma. Observe o uso dos construtores new Date()
e os números fornecidos para cada data usando meses com base no valor zero, conforme mencionado anteriormente.
google.charts.load('current', {'packages':['timeline']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = new google.visualization.DataTable(); data.addColumn('string', 'Team'); data.addColumn('date', 'Season Start Date'); data.addColumn('date', 'Season End Date'); data.addRows([ ['Baltimore Ravens', new Date(2000, 8, 5), new Date(2001, 1, 5)], ['New England Patriots', new Date(2001, 8, 5), new Date(2002, 1, 5)], ['Tampa Bay Buccaneers', new Date(2002, 8, 5), new Date(2003, 1, 5)], ['New England Patriots', new Date(2003, 8, 5), new Date(2004, 1, 5)], ['New England Patriots', new Date(2004, 8, 5), new Date(2005, 1, 5)], ['Pittsburgh Steelers', new Date(2005, 8, 5), new Date(2006, 1, 5)], ['Indianapolis Colts', new Date(2006, 8, 5), new Date(2007, 1, 5)], ['New York Giants', new Date(2007, 8, 5), new Date(2008, 1, 5)], ['Pittsburgh Steelers', new Date(2008, 8, 5), new Date(2009, 1, 5)], ['New Orleans Saints', new Date(2009, 8, 5), new Date(2010, 1, 5)], ['Green Bay Packers', new Date(2010, 8, 5), new Date(2011, 1, 5)], ['New York Giants', new Date(2011, 8, 5), new Date(2012, 1, 5)], ['Baltimore Ravens', new Date(2012, 8, 5), new Date(2013, 1, 5)], ['Seattle Seahawks', new Date(2013, 8, 5), new Date(2014, 1, 5)], ]); var options = { height: 450, timeline: { groupByRowLabel: true } }; var chart = new google.visualization.Timeline(document.getElementById('chart_div')); chart.draw(data, options); }
Datas e hora usando o construtor de datas
O tipo de dados da coluna datetime
da DataTable usa o mesmo construtor de dados que o tipo date
, mas agora usa todos os argumentos para preencher a hora.
Como alternativa, uma representação de string de datetime
também pode ser transmitida para o
construtor Date. Uma representação de string de datetime
consiste em adicionar as horas, os minutos e os segundos, além da compensação de fuso horário de quatro dígitos. Por exemplo, o horário padrão do Pacífico (PST, na sigla em inglês) é -0800. Para a especificação RFC 2822, a hora e o fuso horário são adicionados com espaços entre a data e a hora, e a hora e o fuso horário. Na especificação ISO 8601, não há
espaços, mas a data é seguida por um "T" em letra maiúscula para indicar um componente de tempo. Também
não há espaço entre o horário e o deslocamento do fuso horário. A string de data datetime
completa para 6 de dezembro de 2014 às 10h30 PST seria:
- RFC 2822:
Dec 6, 2014 10:30:00 -0800
- ISO 8601:
2014-12-06T10:30:00-0800
.
Aviso: mais uma vez, a representação da string pode ser analisada de maneira diferente por navegadores/versões diferentes. Ao lidar com horário e fuso horário, há diferenças entre a data e hora ser retornada com um fuso horário UTC (GMT) ou compensada e retornada no horário local. Esse é outro motivo para o uso de strings de data e hora não ser recomendado.
A linha do tempo abaixo detalha um dia médio, usando o tipo de dados datetime.
google.charts.load('current', {'packages':['timeline']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = google.visualization.arrayToDataTable([ ['Activity', 'Start Time', 'End Time'], ['Sleep', new Date(2014, 10, 15, 0, 30), new Date(2014, 10, 15, 6, 30)], ['Eat Breakfast', new Date(2014, 10, 15, 6, 45), new Date(2014, 10, 15, 7)], ['Get Ready', new Date(2014, 10, 15, 7, 4), new Date(2014, 10, 15, 7, 30)], ['Commute To Work', new Date(2014, 10, 15, 7, 30), new Date(2014, 10, 15, 8, 30)], ['Work', new Date(2014, 10, 15, 8, 30), new Date(2014, 10, 15, 17)], ['Commute Home', new Date(2014, 10, 15, 17), new Date(2014, 10, 15, 18)], ['Gym', new Date(2014, 10, 15, 18), new Date(2014, 10, 15, 18, 45)], ['Eat Dinner', new Date(2014, 10, 15, 19), new Date(2014, 10, 15, 20)], ['Get Ready For Bed', new Date(2014, 10, 15, 21), new Date(2014, 10, 15, 22)] ]); var options = { height: 450, }; var chart = new google.visualization.Timeline(document.getElementById('chart_div')); chart.draw(data, options); }
Datas, horários e fusos horários
Usar o construtor de data para date
ou datetime
retornará a data ou a data/hora desejada no fuso horário definido pelo navegador do usuário.
É possível definir o objeto "Date" como um fuso horário específico de algumas maneiras. Primeiro, o Gráficos Google fornece um Formatador de data, em que você pode especificar um timeZone
. Isso fornecerá um valor formatado para cada um dos
valores date
e datetime
na DataTable. Você também pode transmitir uma string como seu argumento para o construtor new Date()
ou agrupar os argumentos no método Date.UTC()
, como:
new Date(Date.UTC(Year, Month, Day, Hours, Minutes, Seconds, Milliseconds))
Isso definirá um objeto "Date" como a data e a hora especificadas no fuso horário UTC (GMT). A partir daí, é possível calcular o deslocamento desejado para o fuso horário e definir as datas e os horários conforme desejado.
Datas e horas usando a representação de string de data
Ao serializar dados usando a notação literal de objeto DataTable do JavaScript para criar sua DataTable, não é possível usar o construtor new Date()
. Em vez disso,
os Gráficos Google oferecem uma representação de string de data que permite que date
ou
datetime
sejam serializados e analisados corretamente ao criar uma DataTable. Esse formato de string de data simplesmente descarta a palavra-chave new
e une a expressão restante entre aspas:
"Date(Year, Month, Day, Hours, Minutes, Seconds, Milliseconds)"
Importante:ao usar essa representação de string de data, como no construtor new Date()
, os meses são indexados a partir de zero (janeiro é o mês 0, dezembro é o mês 11).
Veja abaixo o mesmo cronograma do Super Bowl de antes, mas agora usando a notação literal de objeto JavaScript e o formato de string de data.
google.charts.load('current', {'packages':['timeline']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = new google.visualization.DataTable({ cols: [ {id: 'team', label: 'Team', type: 'string'}, {id: 'start', label: 'Season Start Date', type: 'date'}, {id: 'end', label: 'Season End Date', type: 'date'} ], rows: [ {c: [{v: 'Baltimore Ravens'}, {v: 'Date(2000, 8, 5)'}, {v: 'Date(2001, 1, 5)'}]}, {c: [{v: 'New England Patriots'}, {v: 'Date(2001, 8, 5)'}, {v: 'Date(2002, 1, 5)'}]}, {c: [{v: 'Tampa Bay Buccaneers'}, {v: 'Date(2002, 8, 5)'}, {v: 'Date(2003, 1, 5)'}]}, {c: [{v: 'New England Patriots'}, {v: 'Date(2003, 8, 5)'}, {v: 'Date(2004, 1, 5)'}]}, {c: [{v: 'New England Patriots'}, {v: 'Date(2004, 8, 5)'}, {v: 'Date(2005, 1, 5)'}]}, {c: [{v: 'Pittsburgh Steelers'}, {v: 'Date(2005, 8, 5)'}, {v: 'Date(2006, 1, 5)'}]}, {c: [{v: 'Indianapolis Colts'}, {v: 'Date(2006, 8, 5)'}, {v: 'Date(2007, 1, 5)'}]}, {c: [{v: 'New York Giants'}, {v: 'Date(2007, 8, 5)'}, {v: 'Date(2008, 1, 5)'}]}, {c: [{v: 'Pittsburgh Steelers'}, {v: 'Date(2008, 8, 5)'}, {v: 'Date(2009, 1, 5)'}]}, {c: [{v: 'New Orleans Saints'}, {v: 'Date(2009, 8, 5)'}, {v: 'Date(2010, 1, 5)'}]}, {c: [{v: 'Green Bay Packers'}, {v: 'Date(2010, 8, 5)'}, {v: 'Date(2011, 1, 5)'}]}, {c: [{v: 'New York Giants'}, {v: 'Date(2011, 8, 5)'}, {v: 'Date(2012, 1, 5)'}]}, {c: [{v: 'Baltimore Ravens'}, {v: 'Date(2012, 8, 5)'}, {v: 'Date(2013, 1, 5)'}]}, {c: [{v: 'Seattle Seahawks'}, {v: 'Date(2013, 8, 5)'}, {v: 'Date(2014, 1, 5)'}]} ] }); var options = { height: 450, timeline: { groupByRowLabel: true } }; var chart = new google.visualization.Timeline(document.getElementById('chart_div')); chart.draw(data, options); }
Esse formato também pode ser usado no método arrayToDataTable()
, desde que na
primeira matriz, em que os rótulos das colunas sejam especificados, você declare a coluna necessária como sendo de
type: 'date'
ou type: 'datetime'
.
var data = google.visualization.arrayToDataTable([ ["Team", {type: 'date', label: 'Season Start Date'}, {type: 'date', label: 'Season End Date'}], ["Baltimore Ravens", "Date(2000, 8, 5)", "Date(2001, 1, 5)"], ["New England Patriots", "Date(2001, 8, 5)", "Date(2002, 1, 5)"], ["Tampa Bay Buccaneers", "Date(2002, 8, 5)", "Date(2003, 1, 5)"], ["New England Patriots", "Date(2003, 8, 5)", "Date(2004, 1, 5)"], ["New England Patriots", "Date(2004, 8, 5)", "Date(2005, 1, 5)"], ["Pittsburgh Steelers", "Date(2005, 8, 5)", "Date(2006, 1, 5)"], ["Indianapolis Colts", "Date(2006, 8, 5)", "Date(2007, 1, 5)"], ["New York Giants", "Date(2007, 8, 5)", "Date(2008, 1, 5)"], ["Pittsburgh Steelers", "Date(2008, 8, 5)", "Date(2009, 1, 5)"], ["New Orleans Saints", "Date(2009, 8, 5)", "Date(2010, 1, 5)"], ["Green Bay Packers", "Date(2010, 8, 5)", "Date(2011, 1, 5)"], ["New York Giants", "Date(2011, 8, 5)", "Date(2012, 1, 5)"], ["Baltimore Ravens", "Date(2012, 8, 5)", "Date(2013, 1, 5)"], ["Seattle Seahawks", "Date(2013, 8, 5)", "Date(2014, 1, 5)"] ]);
Como trabalhar com o Timeofday
O tipo de dados da coluna DataTable timeofday
usa uma matriz de três ou quatro números, representando horas, minutos, segundos e, opcionalmente, milissegundos, respectivamente. Usar
timeofday
é diferente de usar date
e datetime
, porque
os valores não são específicos a uma data, enquanto date
e datetime
sempre especificam uma data.
Por exemplo, o horário 8:30 seria: [8, 30, 0, 0]
, com o quarto valor sendo opcional ([8, 30, 0]
resultaria no mesmo valor de timeofday).
google.charts.load('current', {'packages':['bar']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = new google.visualization.DataTable(); data.addColumn('timeofday', 'Time of Day'); data.addColumn('number', 'Emails Received'); data.addRows([ [[8, 30, 45], 5], [[9, 0, 0], 10], [[10, 0, 0, 0], 12], [[10, 45, 0, 0], 13], [[11, 0, 0, 0], 15], [[12, 15, 45, 0], 20], [[13, 0, 0, 0], 22], [[14, 30, 0, 0], 25], [[15, 12, 0, 0], 30], [[16, 45, 0], 32], [[16, 59, 0], 42] ]); var options = { title: 'Total Emails Received Throughout the Day', height: 450 }; var chart = new google.charts.Bar(document.getElementById('chart_div')); chart.draw(data, google.charts.Bar.convertOptions(options)); }
Formatação de rótulos de eixo, grade e marcação
Ao trabalhar com datas, data e hora, talvez seja preciso formatar os rótulos do eixo e das linhas de grade de alguma maneira. Isso pode ser feito de algumas maneiras.
Primeiro, use a opção hAxis.format
ou vAxis.format
. Essa
opção se aplica quando a opção gridlines.count
é omitida. Nesse caso, o gráfico
assume como padrão uma contagem de 5 e quando é definido como um número diferente de -1. Isso permite
especificar uma string de formato, em que você usa letras de marcador para diferentes partes da
data/hora/hora. Consulte a referência do
formatador de datas,
especificamente a seção pattern
, para ver mais informações sobre os marcadores e
como eles funcionam.
google.charts.load('current', {'packages':['corechart']}); google.charts.setOnLoadCallback(drawChart); function drawChart() { var data = new google.visualization.DataTable(); data.addColumn('date', 'Time of Day'); data.addColumn('number', 'Rating'); data.addRows([ [new Date(2015, 0, 1), 5], [new Date(2015, 0, 2), 7], [new Date(2015, 0, 3), 3], [new Date(2015, 0, 4), 1], [new Date(2015, 0, 5), 3], [new Date(2015, 0, 6), 4], [new Date(2015, 0, 7), 3], [new Date(2015, 0, 8), 4], [new Date(2015, 0, 9), 2], [new Date(2015, 0, 10), 5], [new Date(2015, 0, 11), 8], [new Date(2015, 0, 12), 6], [new Date(2015, 0, 13), 3], [new Date(2015, 0, 14), 3], [new Date(2015, 0, 15), 5], [new Date(2015, 0, 16), 7], [new Date(2015, 0, 17), 6], [new Date(2015, 0, 18), 6], [new Date(2015, 0, 19), 3], [new Date(2015, 0, 20), 1], [new Date(2015, 0, 21), 2], [new Date(2015, 0, 22), 4], [new Date(2015, 0, 23), 6], [new Date(2015, 0, 24), 5], [new Date(2015, 0, 25), 9], [new Date(2015, 0, 26), 4], [new Date(2015, 0, 27), 9], [new Date(2015, 0, 28), 8], [new Date(2015, 0, 29), 6], [new Date(2015, 0, 30), 4], [new Date(2015, 0, 31), 6], [new Date(2015, 1, 1), 7], [new Date(2015, 1, 2), 9] ]); var options = { title: 'Rate the Day on a Scale of 1 to 10', width: 900, height: 500, hAxis: { format: 'M/d/yy', gridlines: {count: 15} }, vAxis: { gridlines: {color: 'none'}, minValue: 0 } }; var chart = new google.visualization.LineChart(document.getElementById('chart_div')); chart.draw(data, options); var button = document.getElementById('change'); button.onclick = function () { // If the format option matches, change it to the new option, // if not, reset it to the original format. options.hAxis.format === 'M/d/yy' ? options.hAxis.format = 'MMM dd, yyyy' : options.hAxis.format = 'M/d/yy'; chart.draw(data, options); }; }
Também é possível fornecer regras de formatação para unidades específicas de valores de data e hora, incluindo uma opção units
em gridlines
e minorGridlines
para os dois eixos. Essa opção só será usada se a opção gridlines.count
estiver definida como -1.
A opção gridlines.units
é um objeto em que você especifica o formato dos
diferentes aspectos de data/hora/hora do dia para a linha de grade calculada e seu gráfico calcula
as linhas com base no primeiro formato que se encaixa no espaço para o rótulo de linha de grade.
Você pode definir os formatos para anos, meses, dias, horas, minutos, segundos e milissegundos.
A opção de formato aceita uma matriz de formatos de string e os usará em ordem até que um deles se ajuste à área do rótulo. Por esse motivo, recomendamos listar os formatos em ordem, do mais longo para o mais curto. Os formatos de string usam os mesmos padrões da referência de formatador de datas mencionada anteriormente.
No gráfico acima, ao mudar a janela de visualização, o formato da
unidade hours
muda, já que o horário de funcionamento muda da menor para a maior linha de grade,
e o formato nas opções muda com ela. Além disso, observe que linhas de grade menor estão usando o segundo formato, mais curto, porque os primeiros formatos não cabem no espaço em cada instância.
hAxis: { viewWindow: { min: new Date(2014, 11, 31, 18), max: new Date(2015, 0, 3, 1) }, gridlines: { count: -1, units: { days: {format: ['MMM dd']}, hours: {format: ['HH:mm', 'ha']}, } }, minorGridlines: { units: { hours: {format: ['hh:mm:ss a', 'ha']}, minutes: {format: ['HH:mm a Z', ':mm']} } } }
Mais informações sobre datas do JavaScript
Para saber mais sobre o objeto Date()
JavaScript, a Mozilla Developer Network é um ótimo recurso. Lá, você vai saber tudo sobre
objetos JavaScript de data.