1// Copyright (c) 2011 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5// Basic time formatting methods. These methods use the current locale 6// formatting for displaying the time. 7 8#ifndef BASE_I18N_TIME_FORMATTING_H_ 9#define BASE_I18N_TIME_FORMATTING_H_ 10#pragma once 11 12#include "base/string16.h" 13 14namespace base { 15 16class Time; 17 18// Argument type used to specify the hour clock type. 19enum HourClockType { 20 k12HourClock, // Uses 1-12. e.g., "3:07 PM" 21 k24HourClock, // Uses 0-23. e.g., "15:07" 22}; 23 24// Returns the time of day, e.g., "3:07 PM". 25string16 TimeFormatTimeOfDay(const Time& time); 26 27// Returns the time of day in the specified hour clock type. e.g. 28// "3:07 PM" (type == k12HourClock). 29// "15:07" (type == k24HourClock). 30string16 TimeFormatTimeOfDayWithHourClockType(const Time& time, 31 HourClockType type); 32 33// Returns a shortened date, e.g. "Nov 7, 2007" 34string16 TimeFormatShortDate(const Time& time); 35 36// Returns a numeric date such as 12/13/52. 37string16 TimeFormatShortDateNumeric(const Time& time); 38 39// Formats a time in a friendly sentence format, e.g. 40// "Monday, March 6, 2008 2:44:30 PM". 41string16 TimeFormatShortDateAndTime(const Time& time); 42 43// Formats a time in a friendly sentence format, e.g. 44// "Monday, March 6, 2008 2:44:30 PM". 45string16 TimeFormatFriendlyDateAndTime(const Time& time); 46 47// Formats a time in a friendly sentence format, e.g. 48// "Monday, March 6, 2008". 49string16 TimeFormatFriendlyDate(const Time& time); 50 51// Gets the hour clock type of the current locale. e.g. 52// k12HourClock (en-US). 53// k24HourClock (en-GB). 54HourClockType GetHourClockType(); 55 56} // namespace base 57 58#endif // BASE_I18N_TIME_FORMATTING_H_ 59