Compartilhar via

Carimbos de data/hora personalizados em notificações de aplicativos

  • Artigo

Por padrão, o carimbo de data/hora nas notificações do aplicativo, que é visível no Centro de Notificações, é definido como a hora em que a notificação foi enviada. Opcionalmente, você pode substituir o carimbo de data/hora por sua própria data e hora personalizadas, para que o carimbo de data/hora represente a hora em que a mensagem/informação/conteúdo foi realmente criado, em vez da hora em que a notificação foi enviada. Isso também garante que suas notificações apareçam na ordem correta no Centro de Notificações, que é classificada por hora. Recomendamos que a maioria dos aplicativos especifique um carimbo de data/hora personalizado.

Esse recurso está disponível no Windows Build 15063 e posterior.

Notificação de aplicativo com carimbo de data/hora personalizado

Observação

O termo "notificação do sistema" está sendo substituído por "notificação de aplicativo". Esses termos se referem ao mesmo recurso do Windows, mas com o tempo eliminaremos gradualmente o uso de "notificação do sistema" na documentação.

Para utilizar um carimbo de data/hora personalizado, basta atribuir a propriedade displayTimestamp no elemento toast da carga XML de notificação do aplicativo. A partir do SDK do Aplicativo Windows 1.2, você pode adicionar um carimbo de data/hora personalizado a uma notificação de aplicativo com Microsoft.Windows.AppNotifications.Builder. Para aplicativos UWP, você pode utilizar a versão 1.4.0 ou posterior da biblioteca NuGet de Notificações do Kit de Ferramentas da Comunidade UWP. Também pode especificar o carimbo de data/hora usando xml bruto.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Se estiver usando XML, a data deve ser formatada em ISO 8601.

Observação

Você somente pode utilizar no máximo 3 casas decimais nos segundos (embora realisticamente não haja valor em fornecer nada que granular). Se você fornecer mais, a carga será inválida, e você receberá a notificação "Nova notificação".

Diretriz de uso

Em geral, recomendamos que a maioria dos aplicativos especifique um carimbo de data/hora personalizado. Isso garante que o carimbo de data/hora da notificação represente com precisão quando a mensagem/informação/conteúdo foi gerado, independentemente de atrasos de rede, modo avião ou intervalo fixo de tarefas periódicas em segundo plano.

Por exemplo, um aplicativo de notícias pode executar uma tarefa em segundo plano a cada 15 minutos que verifica novos artigos e mostra notificações. Antes dos carimbos de data/hora personalizados, o carimbo de data/hora correspondia a quando a notificação do aplicativo era gerada (portanto, sempre em intervalos de 15 minutos). Porém, agora o aplicativo pode definir o carimbo de data/hora como a hora em que o artigo foi realmente publicado. Da mesma forma, aplicativos de email e aplicativos de redes sociais podem se beneficiar desse recurso se um padrão semelhante de extração periódica for usado para suas notificações.

Além disso, fornecer um carimbo de data/hora personalizado garante que o carimbo de data/hora esteja correto, mesmo que o usuário tenha sido desconectado da Internet. Por exemplo, quando o usuário liga o computador e a tarefa em segundo plano é executada, você pode finalmente garantir que o carimbo de data/hora nas notificações represente a hora em que as mensagens foram enviadas, e não a hora em que o usuário ligou o computador.

Carimbo de data/hora padrão

Se você não fornecer um carimbo de data/hora personalizado, utilizaremos a hora em que sua notificação foi enviada.

Se você enviou uma notificação por push por meio do WNS, utilizaremos a hora em que a notificação foi recebida pelo servidor WNS (portanto, latências na entrega da notificação ao dispositivo não afetarão o carimbo de data/hora).

Se você enviou uma notificação local, usamos o horário em que a plataforma de notificação recebeu a notificação (que deve ser imediata).