Office.Time interface

Obtém a hora de início ou de término de um compromisso.

A data e hora são fornecidas como um Date objeto na asyncResult.value propriedade . O valor está no Tempo Universal Coordenado (UTC). Pode converter a hora UTC para a hora do cliente local com o convertToLocalClientTime método .

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<Date>) => void): void;

Parâmetros

Retornos

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose

Obtém a hora de início ou de término de um compromisso.

A data e hora são fornecidas como um Date objeto na asyncResult.value propriedade . O valor está no Tempo Universal Coordenado (UTC). Pode converter a hora UTC para a hora do cliente local com o convertToLocalClientTime método .

getAsync(callback: (asyncResult: Office.AsyncResult<Date>) => void): void;

Parâmetros

Retornos

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Compose

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-start-appointment-organizer.yaml

Office.context.mailbox.item.start.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Appointment starts: ${result.value}`);
});

Define a hora de início ou de término de um compromisso.

Se o setAsync método for chamado na propriedade start, a end propriedade será ajustada para manter a duração do compromisso conforme definido anteriormente. Se o método setAsync for chamado na propriedade end, a duração do compromisso será ampliada para a nova hora de término.

A hora deve estar em UTC; você pode obter o horário UTC correto usando o método convertToUtcClientTime.

Importante: no cliente Windows, não pode utilizar este método para atualizar o início ou o fim de uma periodicidade.

setAsync(dateTime: Date, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

Retornos

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compose

Erros:

• InvalidEndTime : A hora de fim do compromisso é anterior à hora de início do compromisso.

Exemplos

const startTime = new Date("3/14/2015");
const options = {
    // Pass information that can be used in the callback.
    asyncContext: {verb: "Set"}
};
Office.context.mailbox.item.start.setAsync(startTime, options, function(result) {
    if (result.error) {
        console.debug(result.error);
    } else {
        // Access the asyncContext that was passed to the setAsync method.
        console.debug("Start Time " + result.asyncContext.verb);
    }
});

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-start-appointment-organizer.yaml

const start = new Date(); // Represents current date and time.
start.setDate(start.getDate() + 2); // Add 2 days to current date.
Office.context.mailbox.item.start.setAsync(start, (result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Successfully set start date and time to ${start}`);
});

...

Office.context.mailbox.item.start.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Get start date failed with message ${result.error.message}`);
    return;
  }

  const end = result.value; // Set end to current start date and time.
  end.setDate(end.getDate() + 1); // Set end as 1 day later than start date.
  Office.context.mailbox.item.end.setAsync(end, (result) => {
    if (result.status !== Office.AsyncResultStatus.Succeeded) {
      console.error(`Set end date failed with message ${result.error.message}`);
      return;
    }
    console.log(`Successfully set end date and time to ${end}`);
  });
});

Define a hora de início ou de término de um compromisso.

Se o setAsync método for chamado na propriedade start, a end propriedade será ajustada para manter a duração do compromisso conforme definido anteriormente. Se o método setAsync for chamado na propriedade end, a duração do compromisso será ampliada para a nova hora de término.

A hora deve estar em UTC; você pode obter o horário UTC correto usando o método convertToUtcClientTime.

Importante: no cliente Windows, não pode utilizar este método para atualizar o início ou o fim de uma periodicidade.

setAsync(dateTime: Date, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

Retornos

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compose

Erros:

• InvalidEndTime : A hora de fim do compromisso é anterior à hora de início do compromisso.