雄介 太田 / mbed

mbed(SerialHalfDuplex入り)

Fork of mbed by mbed official

rtc_time.h@56:3753e96f3c8b, 2013-01-16 (annotated)

Committer:
emilmont
Date:
Wed Jan 16 14:27:32 2013 +0000
Revision:
56:3753e96f3c8b
Parent:
55:d722ed6a4237
Child:
59:0883845fe643
Add IAR build for LPC1768

Who changed what in which revision?

UserRevisionLine numberNew contents of line
emilmont 44:24d45a770a51 1 /* mbed Microcontroller Library
emilmont 54:71b101360fb9 2 * Copyright (c) 2006-2013 ARM Limited
emilmont 44:24d45a770a51 3 *
emilmont 44:24d45a770a51 4 * Permission is hereby granted, free of charge, to any person obtaining a copy
emilmont 44:24d45a770a51 5 * of this software and associated documentation files (the "Software"), to deal
emilmont 44:24d45a770a51 6 * in the Software without restriction, including without limitation the rights
emilmont 44:24d45a770a51 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
emilmont 44:24d45a770a51 8 * copies of the Software, and to permit persons to whom the Software is
emilmont 44:24d45a770a51 9 * furnished to do so, subject to the following conditions:
emilmont 44:24d45a770a51 10 *
emilmont 44:24d45a770a51 11 * The above copyright notice and this permission notice shall be included in
emilmont 44:24d45a770a51 12 * all copies or substantial portions of the Software.
emilmont 44:24d45a770a51 13 *
emilmont 44:24d45a770a51 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
emilmont 44:24d45a770a51 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
emilmont 44:24d45a770a51 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
emilmont 44:24d45a770a51 17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
emilmont 44:24d45a770a51 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
emilmont 44:24d45a770a51 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
emilmont 44:24d45a770a51 20 * SOFTWARE.
emilmont 44:24d45a770a51 21 */
emilmont 44:24d45a770a51 22
emilmont 44:24d45a770a51 23 #include <time.h>
emilmont 44:24d45a770a51 24
emilmont 44:24d45a770a51 25 #ifdef __cplusplus
emilmont 44:24d45a770a51 26 extern "C" {
emilmont 44:24d45a770a51 27 #endif
emilmont 44:24d45a770a51 28
emilmont 44:24d45a770a51 29 /** Implementation of the C time.h functions
emilmont 44:24d45a770a51 30 *
emilmont 44:24d45a770a51 31 * Provides mechanisms to set and read the current time, based
emilmont 55:d722ed6a4237 32 * on the microcontroller Real-Time Clock (RTC), plus some
emilmont 55:d722ed6a4237 33 * standard C manipulation and formating functions.
emilmont 44:24d45a770a51 34 *
emilmont 44:24d45a770a51 35 * Example:
emilmont 44:24d45a770a51 36 * @code
emilmont 44:24d45a770a51 37 * #include "mbed.h"
emilmont 44:24d45a770a51 38 *
emilmont 44:24d45a770a51 39 * int main() {
emilmont 44:24d45a770a51 40 * set_time(1256729737); // Set RTC time to Wed, 28 Oct 2009 11:35:37
emilmont 55:d722ed6a4237 41 *
emilmont 55:d722ed6a4237 42 * while(1) {
emilmont 44:24d45a770a51 43 * time_t seconds = time(NULL);
emilmont 55:d722ed6a4237 44 *
emilmont 44:24d45a770a51 45 * printf("Time as seconds since January 1, 1970 = %d\n", seconds);
emilmont 55:d722ed6a4237 46 *
emilmont 44:24d45a770a51 47 * printf("Time as a basic string = %s", ctime(&seconds));
emilmont 44:24d45a770a51 48 *
emilmont 44:24d45a770a51 49 * char buffer[32];
emilmont 44:24d45a770a51 50 * strftime(buffer, 32, "%I:%M %p\n", localtime(&seconds));
emilmont 44:24d45a770a51 51 * printf("Time as a custom formatted string = %s", buffer);
emilmont 55:d722ed6a4237 52 *
emilmont 44:24d45a770a51 53 * wait(1);
emilmont 44:24d45a770a51 54 * }
emilmont 44:24d45a770a51 55 * }
emilmont 44:24d45a770a51 56 * @endcode
emilmont 44:24d45a770a51 57 */
emilmont 44:24d45a770a51 58
emilmont 44:24d45a770a51 59 /** Set the current time
emilmont 44:24d45a770a51 60 *
emilmont 44:24d45a770a51 61 * Initialises and sets the time of the microcontroller Real-Time Clock (RTC)
emilmont 55:d722ed6a4237 62 * to the time represented by the number of seconds since January 1, 1970
emilmont 55:d722ed6a4237 63 * (the UNIX timestamp).
emilmont 55:d722ed6a4237 64 *
emilmont 55:d722ed6a4237 65 * @param t Number of seconds since January 1, 1970 (the UNIX timestamp)
emilmont 44:24d45a770a51 66 *
emilmont 44:24d45a770a51 67 * Example:
emilmont 44:24d45a770a51 68 * @code
emilmont 44:24d45a770a51 69 * #include "mbed.h"
emilmont 44:24d45a770a51 70 *
emilmont 44:24d45a770a51 71 * int main() {
emilmont 44:24d45a770a51 72 * set_time(1256729737); // Set time to Wed, 28 Oct 2009 11:35:37
emilmont 44:24d45a770a51 73 * }
emilmont 44:24d45a770a51 74 * @endcode
emilmont 55:d722ed6a4237 75 */
emilmont 44:24d45a770a51 76 void set_time(time_t t);
emilmont 44:24d45a770a51 77
emilmont 44:24d45a770a51 78 #ifdef __cplusplus
emilmont 44:24d45a770a51 79 }
emilmont 44:24d45a770a51 80 #endif