Title: Eco.DateTime1 Software Component Specification
USPD: US.ECO.00001-01 90
Component Name: Eco.DateTime1
Short Description (max 300 char.): implements date-time operations
Component Use Category: MULTIPURPOSE
Component Type: UTILITY
CID: 5B2BA17BEA704527BC708F88568FE115
Marketplace URL: https://ecoos.dev/product/b6ec9d3f-4f3f-4f33-9d88-3be2112a6a27
Status: Draft
Modified Date: November 8, 2025
Version: 1.0
Tags: Date, Time, DateTime, Time zone
| Authors | Company |
|---|---|
| Vladimir Bashev | PEERF |
Table of Contents
3.1. IEcoDateTime1 interface IDL descriptor
3.1.3. get_SystemTime function
3.1.4. set_SystemTime function
3.1.5. get_TimeOfDaySec function
3.1.6. get_TimeOfDayUSec function
3.1.8. ToStringFormat function
Appendix A: Sample code and Training programs
1. Overview
This document describes the requirements for the implementation of the Eco.DateTime1 component.
1.1. Introduction
Description.
1.2. Notes
- Keywords
1.3. Links
This paragraph contains links1.3. Links to component in Marketplace and other information to help understanding this document:
Available in Marketplace at: https://ecoos.dev/product/b6ec9d3f-4f3f-4f33-9d88-3be2112a6a27
2. Eco.DateTime1 Component
The Eco.DateTime1 component implements DateTime functions
The component has the following features: TBA
3. IEcoDateTime1 Interface
3.1. IEcoDateTime1 interface IDL descriptor
import "IEcoBase1.h"
[
object,
uguid(CA5A4E0E-7EEB-4CA9-92C6-22043FFA07BC),
]
interface IEcoDateTime1 : IEcoUnknown {
IEcoDateTime1* Now ([in] void);
IEcoDateTime1* Clone ([in] void);
ECITIMEVAL* get_SystemTime ([in] void);
void set_SystemTime ([in] ECOTIMEVAL* value);
int32_t get_TimeOfDaySec ([in] void);
int32_t get_TimeOfDayUSec ([in] void);
char_t* ToString ([in] void);
char_t* ToStringFormat ([in] char_t *format);
}3.1.1. Now function
The function gets a DateTime object that is set to the current date and time on this computer, expressed as the local time
3.1.2. Clone function
The function
3.1.3. get_SystemTime function
The function gets the currently selected time from a date and time picker (DTP) control and places it in a specified SYSTEMTIME structure.
3.1.4. set_SystemTime function
The function sets a date and time picker (DTP) control to a given date and time.
3.1.5. get_TimeOfDaySec function
The function
3.1.6. get_TimeOfDayUSec function
The function
3.1.7. ToString function
The function converts the value of the current DateTime object to its equivalent string representation.
3.1.8. ToStringFormat function
3.1.8. ToStringFormat function
The function converts the value of the current DateTime object to its equivalent string representation using the specified formatting information associated with the language and regional parameters.
4. Error codes
The following table contains the error codes.
| Error code | Value | Description |
|---|---|---|
| ERR_ECO_SUCCESES | 0x0000 | Operation successful. |
| ERR_ECO_UNEXPECTED | 0xFFFF | Unexpected condition. |
| ERR_ECO_POINTER | 0xFFEE | NULL was passed incorrectly for a pointer value. |
| ERR_ECO_NOINTERFACE | 0xFFED | No such interface supported. |
| ERR_ECO_COMPONENT_NOTFOUND | 0xFFE9 | The component was not found. |