Personalizar o carimbo de data e hora

Personalize carimbos de data e hora usando Livefyre.js.

Os aplicativos Livefyre fornecem o parâmetro de opção, datetimeFormat, para especificar o formato de data, conforme descrito abaixo.

• Terminologia
• Formatação
• Designação do símbolo

Terminologia

• Os carimbos de data e hora absolutos são definidos como horas exatas e específicas (por exemplo, 1º de janeiro de 2012, 12:00 horas)
• Os carimbos de data e hora relativos são definidos como tempos gerais e menos precisos (por exemplo, 25 segundos atrás, 14 minutos atrás, 1 dia atrás, 1 ano atrás etc.)

Formatação

O parâmetro datetimeFormat tem o seguinte comportamento padrão quando nenhum argumento é fornecido:

• Formato de data e hora de: MMMM d yyyy (para 8 de janeiro de 2012)
• 20160 Minutos (14 dias) até o tempo absoluto (14 dias até que os carimbos de data e hora relativos se tornem carimbos de data e hora absolutos)

O parâmetro datetimeFormat aceita três tipos de argumento possíveis: datetime, format e string.

// Example 1 (Datetime format string)  
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": 'MMM d y Ka' 
}; 
var conv = fyre.conv.load(networkConfig, [convConfig]);

Um objeto que especifica a forma absolutaFormat e/ou a minutosAtéAbsoluteTime. Um minutosAtéAbsoluteTime com um valor de -1 tornará o tempo absoluto imediato.

// Example 2 (Object)  
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": { 
      minutesUntilAbsoluteTime: 10, 
      absoluteFormat: 'MMM d y Ka' 
   } 
};  
var conv = fyre.conv.load(networkConfig, [convConfig]);

Uma função que usa como argumento um objeto Date e retorna uma string datetime para ser exibida

// Example 3 (Function accepting a Date object, returning a datetime string to display) 
var convConfig = { 
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo", 
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc", 
   "siteId":"12345", 
   "articleId":5, 
   "el":"comments1", 
   "datetimeFormat": function(theDateInput) { 
      return +theDateInput; 
   } 
};  
var conv = fyre.conv.load(networkConfig, [convConfig]);

Designação do símbolo

Funções de formatação de data e hora seguindo a especificação de padrão, conforme definido em JDK, ICU e CLDR, com pequena modificação para uso típico em JS. Para obter mais informações, consulte a Documentação da Biblioteca de Fechamento do Google.

  Symbol Meaning Presentation        Example 
  ------   -------                 ------------        ------- 
  G        era designator          (Text)              AD 
  y#       year                    (Number)            1996 
  Y* year (week of year)     (Number)            1997 
  u* extended year           (Number)            4601 
  M        month in year           (Text & Number)     July & 07 
  d        day in month            (Number)            10 
  h        hour in am/pm (1~12)    (Number)            12 
  H        hour in day (0~23)      (Number)            0 
  m        minute in hour          (Number)            30 
  s        second in minute        (Number)            55 
  S        fractional second       (Number)            978 
  E        day of week             (Text)              Tuesday 
  e* day of week (local 1~7) (Number)            2 
  D* day in year             (Number)            189 
  F* day of week in month    (Number)            2 (2nd Wed in July) 
  w* week in year            (Number)            27 
  W* week in month           (Number)            2 
  a        am/pm marker            (Text)              PM 
  k        hour in day (1~24)      (Number)            24 
  K        hour in am/pm (0~11)    (Number)            0 
  z        time zone               (Text)              Pacific Standard Time 
  Z        time zone (RFC 822)     (Number)            -0800 
  v        time zone (generic)     (Text)              Pacific Time 
  g* Julian day              (Number)            2451334 
  A* milliseconds in day     (Number)            69540000 
  '        escape for text         (Delimiter)         'Date=' 
  ''       single quote            (Literal)           'o''clock'

Os itens marcados com ‘*’ ainda não são suportados.

Os itens marcados com ‘#’ funcionam de forma diferente do Java.

A contagem de letras padrão determina o formato.

• Texto: 4 ou mais, use o formulário completo. Menos de 4, use o formulário curto ou abreviado, se houver. (Por exemplo: "EEEE" produz "Segunda-feira", "EEE" produz "Seg".)
• Número: o número mínimo de dígitos. Números mais curtos são preenchidos com zero para esse valor (por exemplo: Se "m" produzir "6", "mm" produz "06".) O ano é manipulado especialmente; ou seja, se a contagem de "y" for 2, o Ano será truncado para 2 dígitos. (Por exemplo: se "aaaa" produzir "1997", "yy" produz "97".) Ao contrário de outros campos, segundos fracionários são preenchidos à direita com zero.
• Texto e número: 3 ou mais, use texto. Menos de 3, use o número. (Por exemplo: "M" produz "1", "MM" produz "01", "MMM" produz "Jan" e "MMMM" produz "Janeiro".)

Quaisquer caracteres no padrão que não estejam nos intervalos de [‘a’."z’] e [‘A’."Z’] será tratado como texto entre aspas. Por exemplo, caracteres como ‘:’, ‘.’, ‘, ‘#’ e ‘@’ aparecerão no texto de tempo resultante, mesmo que não sejam aceitos entre aspas simples.