DateParser_1.0.6337.38019 branch creation.

Author: varocarbas

.travis.yml

@@ -2,7 +2,7 @@
 
 [Master source code](https://github.com/varocarbas/FlexibleParser/tree/master/all_code/DateParser/Source)
 
-[https://customsolvers.com/date_parser/](https://customsolvers.com/date_parser/) (ES: [https://customsolvers.com/date_parser_es/](https://customsolvers.com/date_parser_es/)) -- [NuGet package](https://www.nuget.org/packages/DateParser/)
+[https://customsolvers.com/date_parser/](https://customsolvers.com/date_parser/) (ES: [https://customsolvers.com/date_parser_es/](https://customsolvers.com/date_parser_es/)) -- [NuGet package](https://www.nuget.org/packages/DateParser/) -- [Video](https://www.youtube.com/watch?v=E2JT2w66uyc)
 
 ## Introduction
 

all_comments/DateParser.XML DateParser.XMLall_comments/DateParser.XML renamed to DateParser.XML

@@ -1,36 +1,105 @@
-# FlexibleParser        
+# DateParser
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.439945.svg)](https://doi.org/10.5281/zenodo.439945) [![Build Status](https://travis-ci.org/varocarbas/FlexibleParser.svg?branch=master)](https://travis-ci.org/varocarbas/FlexibleParser)
+[Master source code](https://github.com/varocarbas/FlexibleParser/tree/master/all_code/DateParser/Source)
 
+[https://customsolvers.com/date_parser/](https://customsolvers.com/date_parser/) (ES: [https://customsolvers.com/date_parser_es/](https://customsolvers.com/date_parser_es/)) -- [NuGet package](https://www.nuget.org/packages/DateParser/) -- [Video](https://www.youtube.com/watch?v=E2JT2w66uyc)
 
-FlexibleParser is a multi-purpose .NET parsing library based upon the following ideas:
+## Introduction
 
-- Intuitive, adaptable and easy to use.
-- Pragmatic, but aiming for the maximum accuracy and correctness.
-- Overall compatible and easily automatable. 
-- Formed by independent DLLs managing specific situations.
+After adding a reference to the ```FlexibleParser``` namespace, it is possible to start using DateParser right away. The main functionalities of this library can be divided in the following two groups:
+- ```DateTime``` type (C#) enhancements: better string parsing, easier linkage to time zone information and easier modification of constituent elements.
+- Time zones: relevant amount of additional information and more user-friendly usage. 
 
-## Parts
+All the public classes of DateParser have some common features meant to maximise their usability and compatibility. For example, implicit conversions to multiple types or custom ```ToString()``` versions outputting the most adequate information.
 
-At the moment, FlexibleParser is formed by the following independent parts:
+```C#
+//dateP.Value is identical to DateTime.Parse("01-01-2001").
+DateP dateP = new DateP("01-01-2001"); 
+dateP = "01-01-2001";
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.439729.svg)](https://doi.org/10.5281/zenodo.439729) [UnitParser](https://customsolvers.com/unit_parser/) ([last release](https://github.com/varocarbas/FlexibleParser/releases/tag/UnitParser__1.0.6301.23655), [readme file](https://github.com/varocarbas/FlexibleParser/blob/master/all_readme/UnitParser.md), [code analysis](https://varocarbas.com/unit_parser_code/))<br/>
-It allows to easily deal with a wide variety of situations involving units of measurement.
-Among its most salient features are: user-defined exception triggering and gracefully managing numeric values of any size.
+//dateP.Value has the same date than DateTime.ParseExact("02-01-2001", "dd-MM-yyyy", CultureInfo.CurrentCulture)
+//and the current time.
+dateP = new DateP("02-01-2001", new CustomDateTimeFormat("day-month-year"));
 
+//timeZoneWindows.TimeZoneInfo is identical to TimeZoneInfo.FindSystemTimeZoneById("E. Europe Standard Time").
+//Note that TimeZoneInfo.FindSystemTimeZoneById("E Europe Standard Time") triggers an exception.
+TimeZoneWindows timeZoneWindows = new TimeZoneWindows(TimeZoneWindowsEnum.E_Europe_Standard_Time);
+timeZoneWindows = TimeZoneWindowsEnum.E_Europe_Standard_Time;
+```
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.439942.svg)](https://doi.org/10.5281/zenodo.439942) [NumberParser](https://customsolvers.com/number_parser/) ([last release](https://github.com/varocarbas/FlexibleParser/releases/tag/NumberParser_1.0.6302.28051), [readme file](https://github.com/varocarbas/FlexibleParser/blob/master/all_readme/NumberParser.md), [code analysis](https://varocarbas.com/number_parser_code/))<br/>It provides a common framework for all the .NET numeric types. Main features: exceptions managed internally; beyond-double-range support; custom mathematical functionalities.
+## DateP
 
+```DateP``` is the main class of DateParser and improves ```DateTime``` in the following ways:
+- It enables new alternatives to extract the date/time information from strings via ```CustomDateTimeFormat```. 
+- It allows real-time modifications of the ```DateTime``` constituent parts, including the offset of the associated time zone. 
 
-[DateParser](https://customsolvers.com/date_parser/) ([last release](https://github.com/varocarbas/FlexibleParser/tree/master/all_code/DateParser/Source), [readme file](https://github.com/varocarbas/FlexibleParser/blob/master/all_readme/DateParser.md))<br/>It enhances the default .NET date/time support, mostly via improving the usability of its main type and accounting for a big amount of additional time zone information.
 
+```C#
+string[] inputs = new string[]
+{
+    "04-05-2017", "4-may-2017", "04/5-2017", "04 05 2017"
+};
 
-## Authorship & Copyright
+foreach (string input in inputs)
+{
+    DateP dateP = new DateP
+    (
+        input, new CustomDateTimeFormat
+        (
+            new DateTimeParts[]
+            {
+                DateTimeParts.Day, DateTimeParts.Month, DateTimeParts.Year
+            }
+        ), 
+        0m
+    );
+
+    //dateP.Value has always the same date than DateTime.ParseExact("04-05-2017", "dd-MM-yyyy", CultureInfo.CurrentCulture)
+    //and the current time.
+    //Note that DateTime.ParseExact requires specific arguments to deal with each input string. 
+}
+
+//The date of dateP.Value has become 05/05/2017, the first Friday after 04/05/2017.
+dateP.Week = DayOfWeek.Friday;
+
+//The time of dateP.Value is now 3 hours later, the lag between the new offset and the original one.
+dateP.TimeZoneOffset = 3m;
+```
+
+## Time Zones
+
+DateParser supports 6 different types of time zones, each of them is defined by a main class and an enum:
+- [```TimeZoneOfficial```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Official/TimeZones_Types_Official_Constructors.cs)/[```TimeZoneOfficialEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Official/Hardcoding/TimeZones_Types_Official_Hardcoding_Main.cs). 
+- [```TimeZoneIANA```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/IANA/TimeZones_Types_IANA_Constructors.cs)/[```TimeZoneIANAEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/IANA/Hardcoding/TimeZones_Types_IANA_Hardcoding_Main.cs).
+- [```TimeZoneConventional```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Conventional/TimeZones_Types_Conventional_Constructors.cs)/[```TimeZoneConventionalEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Conventional/TimeZones_Types_Conventional_Hardcoding.cs).
+- [```TimeZoneUTC```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/UTC/TimeZones_Types_UTC_Constructors.cs)/[```TimeZoneUTCEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/UTC/TimeZones_Types_UTC_Hardcoding.cs).
+- [```TimeZoneWindows```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Windows/TimeZones_Types_Windows_Constructors.cs)/[```TimeZoneWindowsEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Windows/TimeZones_Types_Windows_Hardcoding.cs).
+- [```TimeZoneMilitary```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Military/TimeZones_Types_Military_Constructors.cs)/[```TimeZoneMilitaryEnum```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Types/Military/TimeZones_Types_Military_Hardcoding.cs).
+
+There are also two other classes dealing with various time zones at the same time:
+- [```TimeZones```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Basic/Constructors/MainClass/TimeZones_Basic_Constructors_MainClass_Main.cs). 
+- [```TimeZonesCountry```](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/DateParser/Source/TimeZones/Country/TimeZones_Country_Constructors.cs). 
 
+
+```C#
+//All the information about the CET time zone.
+TimeZoneOfficial timeZoneOfficial = "CET";
+
+//Time zones of all the types having something in common with the CET time zone.
+TimeZones timezones = new TimeZones(timeZoneOfficial); 
+
+//List with all the pairs of official standard/daylight time zones used in Ponferrada's country (i.e., Spain).
+TimeZonesCountry timeZonesCountry = new TimeZonesCountry("Ponferrada"); 
+```
+
+## Further Code Samples
+The [test application](https://github.com/varocarbas/FlexibleParser/blob/master/all_code/Test/Parts/DateParser.cs) includes a relevant number of descriptive code samples. 
+
+## Authorship & Copyright
 I, Alvaro Carballo Garcia (varocarbas), am the sole author of each single bit of this code.
 
 Equivalently to what happens with all my other online contributions, this code can be considered public domain. For more information about my copyright/authorship attribution ideas, visit the corresponding pages of my sites:
 - https://customsolvers.com/copyright/<br/> 
 ES: https://customsolvers.com/copyright_es/
 - https://varocarbas.com/copyright/<br/>
-ES: https://varocarbas.com/copyright_es/
+ES: https://varocarbas.com/copyright_es/