# time

This page documents the **time** canonical concept dataset. The
[complete XML file](https://developers.google.com/public-data/docs/canonical/time_xml) is also available for review.

## Basic Info

| Name | Google date and time |
| Description | Google date and time dataset |
| Namespace | http://www.google.com/publicdata/dataset/google/time |
| URL | [http://code.google.com/apis/publicdata/docs/canonical/time.html](https://developers.google.com/public-data/docs/canonical/time) |
|---|---|

## Provider

| Name | Google Inc. |
| Description | Google Inc. |
| URL | <http://www.google.com> |
|---|---|

## Imported Namespaces

No imported namespaces.

## Topics

No topics defined.

## Concepts

### Concept: time_point

| ID | time_point \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#time_point)\] |
| Name | Point in time |
| Type | date |
| Description | Point in time, with a given granularity. |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#time_point_granularity) | | ID (implied) | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#time_point_granularity)\] | | Concept | [granularity](https://developers.google.com/public-data/docs/canonical/time#granularity) | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: year

| ID | year \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#year)\] |
| Name | Year date |
| Extends | [time_point](https://developers.google.com/public-data/docs/canonical/time#time_point) |
| Description | A date with yearly granularity. The year concept is usually used directly in a slice definition to define a dimension that contains year. For example, a slice for yearly population by country would be defined as follows: ``` <slices> <slice id="country_slice"> <dimension concept="country"/> <dimension concept="time:year"/> <metric concept="population"/> <table ref="country_slice_table"/> </slice> </slices> ``` The table definition for this slice would be defined as follows: ``` <tables> ... <table id="country_slice_table"> <column id="country" type="text"/> <column id="year" type="date" format="yyyy"/> <column id="population" type="integer"/> <data> <file format="csv" encoding="utf-8">country_slice.csv</file> </data> </table> ... </tables> ``` And the data contained in the CSV file for this table would look like: ``` country, year, population AF, 1960, 9616353 AF, 1961, 9799379 AF, 1962, 9989846 AF, 1963, 10188299 ... ``` |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#year_granularity) | | ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#year_granularity)\] | | Value | YEARLY | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: quarter

| ID | quarter \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#quarter)\] |
| Name | Quarter date |
| Extends | [time_point](https://developers.google.com/public-data/docs/canonical/time#time_point) |
| Description | A date with quarterly granularity. See the example for the year concept above. |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#quarter_granularity) | | ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#quarter_granularity)\] | | Value | QUARTERLY | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: month

| ID | month \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#month)\] |
| Name | Month date |
| Extends | [time_point](https://developers.google.com/public-data/docs/canonical/time#time_point) |
| Description | A date with monthly granularity. See the example for the year concept above. |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#month_granularity) | | ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#month_granularity)\] | | Value | MONTHLY | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: week

| ID | week \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#week)\] |
| Name | Week date |
| Extends | [time_point](https://developers.google.com/public-data/docs/canonical/time#time_point) |
| Description | A date with weekly granularity. See the example for the year concept above. |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#week_granularity) | | ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#week_granularity)\] | | Value | WEEKLY | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: day

| ID | day \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#day)\] |
| Name | Day date |
| Extends | [time_point](https://developers.google.com/public-data/docs/canonical/time#time_point) |
| Description | A date with daily granularity. See the example for the year concept above. |
| Attributes [granularity](https://developers.google.com/public-data/docs/canonical/time#day_granularity) | | ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#day_granularity)\] | | Value | DAILY | |---|---| |
| Properties | No local properties. |
|---|---|

### Concept: granularity

| ID | granularity \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#granularity)\] |
| Name | Granularity |
| Type | string |
| Data | [granularity_table](https://developers.google.com/public-data/docs/canonical/time#granularity_table) |
| Description | Granularity of time, i.e., the uncertainty that a point in time may be anywhere within some time interval. |
| Attributes | No local attributes. |
| Properties | No local properties. |
|---|---|

## Slices

No slices defined.

## Tables

### Table: granularity_table

| ID | granularity_table \[[XML](https://developers.google.com/public-data/docs/canonical/time_xml#granularity_table)\] |
| Data | granularity.csv \[[CSV](https://developers.google.com/public-data/docs/canonical/granularity_csv)\] |
| Columns | | Name | Type | |---|---| | granularity | string | |
|---|---|