Trabalhando com datas
Formatos de data e fusos horários
Ao trabalhar com datas, existem três formatos possíveis que você pode obter:
- Formato de data JSON da Microsoft
- Formato ISO com suporte para fuso horário
- Formato ISO sem suporte para fuso horário
Observação: todos esses formatos também podem ser usados na API. v.1
Formato de data JSON da Microsoft (padrão)
/api/v2/userstories?where=(id=3920)&select={PlannedEndDate}
/api/v2/userstories?where=(id=3920)&select={PlannedEndDate}&dateformat=ms
{
"items": [
{
"plannedEndDate": "\/Date(1517525999000+0100)\/"
}
]
}Formato ISO com suporte para fuso horário
Observação: o fuso horário do servidor Targetprocess é exibido
/api/v2/userstories?where=(id=3920)&select={PlannedEndDate}&dateformat=iso{
"items": [
{
"plannedEndDate": "2018-02-01T23:59:59+01:00"
}
]
}Observação: se você estiver usando uma conta sob demanda, pode verificar abaixo o fuso horário do seu servidor (com e sem horário de verão). Os clientes da nuvem privada podem entrar em contato tp-support@apptio.com para obter essas informações
| Servidor Targetprocess | Fuso Horário | Fuso horário (com horário de verão) |
|---|---|---|
| Amsterdã (UE) | CET (UTC +1) | CEST (UTC +2) |
| Dallas (EUA) | CST (UTC -6)) | CDT (UTC -5)) |
| Melbourne (Austrália) | AEST (UTC +10) | AEDT (UTC +11) |
| Portland | CET (UTC -5)) | CET (UTC -4)) |
| Dublin | IST (UTC +1) | IST (UST +2) |
Formato ISO sem suporte para fuso horário
/api/v2/userstories?where=(id=3920)&select={PlannedEndDate}&isodate=1{
"items": [
{
"plannedEndDate": "2018-02-01T23:59:59"
}
]
}Filtrar por datas
| Filtro | O que faz? |
|---|---|
| PlannedEndDate!=null | Verifica se não PlannedEndDate está vazio |
| PlannedEndDate=null | Verifica se PlannedEndDate está vazio |
| PlannedEndDate>Today | Verifica se PlannedEndDate é posterior a hoje |
| PlannedEndDate\<Today.AddDays(5) | Verifica se PlannedEndDate é antes de 5 dias a partir de hoje |
| PlannedEndDate>Today.AddDays(-5) | Verifica se PlannedEndDate está dentro dos últimos 5 dias |
| PlannedEndDate>DateTime.Analisar("2018-10-31") | Verifica se PlannedEndDate é após 31 de outubro de 2018 |