# DateTime: leren werken met objecten > ![](https://2320684026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FouoIA7Dvx8ty0RZ0Hqs1%2Fuploads%2Fgit-blob-ccb1523c1944719db33fc89944ba5374decaa4a9%2Fattention.png?alt=media)Doe die zwembroek maar weer aan! We gaan nog eens zwemmen. Zoals je vermoedelijk al doorhebt hebben we met properties en methoden nog maar een tipje van de *klasse-ijsberg* besproken. Vreemde dingen zoals *constructors*, *static methoden*, *overerving* en arrays van objecten staan ons nog allemaal te wachten. Om je toch al een voorsmaakje van de kracht van klassen en objecten te geven, gaan we eens kijken naar één van de vele klassen die je tot je beschikking hebt in C#. Je hebt al leren werken met de `Random` klasse. Maar ook al met enkele speciale *static klassen* zoals de `Math`- en `Console`-bibliotheek. Waarom zijn dit *static klassen*? Wel, je kan ze gebruiken **zonder** dat je er objecten van moet aanmaken. Nog zo'n handige ingebouwde klasse is de `DateTime` klasse[^1]. Je raadt het nooit ... een klasse die toelaat om de tijd en datum als een object voor te stellen. De `DateTime` klasse is de ideale manier om te leren werken met objecten. ## DateTime objecten aanmaken Er zijn 2 manieren om `DateTime` objecten aan te maken: ```csharp DateTime huidigeTijd = DateTime.Now; DateTime specialeDag = new DateTime(2017,4,21); ``` * Lijn 1: Door aan de klasse de huidige datum en tijd te vragen via `DateTime.Now`. * Lijn 2: Door manueel de datum en tijd in te stellen met het `new` keyword en de **klasse-constructor** (een concept dat we in hoofdstuk 11 uit de doeken gaan doen) ### DateTime.Now Volgend voorbeeld toont hoe we een object kunnen maken dat de huidige datum tijd van het systeem bevat. Vervolgens printen we dit op het scherm: ```csharp DateTime currentTime = DateTime.Now; Console.WriteLine(currentTime); ``` {% hint style="info" %} `DateTime.Now` is een zogenaamde **static property** wat verderop in het boek zal uitgelegd worden. {% endhint %} ### Met constructor en `new` De constructor van een klasse laat toe om bij het maken van een nieuw object, beginwaarden voor bepaalde instantievariabelen of properties mee te geven. De `DateTime` klasse heeft meerdere constructors gedefiniëerd zodat je bijvoorbeeld een object kan aanmaken dat bij de start reeds de geboortedatum van de auteur bevat: ```csharp DateTime verjaardag = new DateTime(1981, 3, 18); //jaar, maand, dag ``` Ook is er een constructor om startdatum én -tijd mee te geven bij de objectcreatie: ```csharp //Volgorde: jaar, maand, dag, uur, minuten, seconden DateTime trouwMoment = new DateTime(2017, 4, 21, 10, 00,34 ); ``` ## DateTime methoden Van zodra je een `DateTime` object hebt gemaakt zijn er tal van nuttige methoden die je er op kan aanroepen. Visual Studio is zo vriendelijk om dit te visualiseren wanneer we de dot-operator typen achter een object: ![Iedere kubus stelt een methode voor. Iedere Engelse sleutel een property.](https://2320684026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FouoIA7Dvx8ty0RZ0Hqs1%2Fuploads%2Fgit-blob-8c8d362a92fe826677650dd8c9bfe3d37a8a3c93%2Fdatemethods.png?alt=media) ### Add-methoden Deze methoden kan je gebruiken om een bepaalde aantal dagen, uren, minuten op te tellen bij de huidige tijd en datum van een object. De ingebouwde methoden noemen allemaal `AddX`, waar bij X dan vervangen wordt door het soort element dat je wilt toevoegen: `AddDays`, `AddHours`, `AddMilliseconds`, `AddMinutes`, `AddMonths`, `AddSeconds`, `AddTicks`, `AddYears`. Het object zal voor ons de "berekening" hiervan doen en vervolgens een **nieuw DateTime object** teruggeven dat je moet bewaren wil je er iets mee doen. In volgende voorbeeld wil ik ontdekken wanneer de wittebroodsweken van m'n huwelijk eindigen (pakweg 5 weken na de trouwdag). ```csharp DateTime eindeWitteBroodsweken = trouwMoment.AddDays(35); Console.WriteLine(eindeWitteBroodsweken); ``` ## DateTime properties Dit hoofdstuk heeft al aardig wat woorden verspild aan properties, en uiteraard heeft ook de `DateTime` klasse een hele hoop interessante properties die toelaten om de interne staat van een `DateTime` object te bewerken of uit te lezen. Enkele nuttige properties van `DateTime` zijn: `Date`, `Day`, `DayOfWeek`, `DayOfYear`, `Hour`, `Millisecond`, `Minute`, `Month`, `Second`, `Ticks`, `TimeOfDay`, `Today`, `UtcNow`, `Year`. **Alle properties van DateTime zijn read-only** en hebben dus een private setter die we niet kunnen gebruiken. Een voorbeeld: ```csharp Console.WriteLine($"Einde in maand nr: {eindeWitteBroodsweken.Month}."); Console.WriteLine($"Dat is een {eindeWitteBroodsweken.DayOfWeek}."); ``` Dit geeft op het scherm: ``` Je wittebroodsweken eindigen in maand nummer: 5. Dat is een Friday. ``` ## Static methoden Sommige methoden zijn `static` dat wil zeggen dat je ze enkel rechtstreeks op de klasse kunt aanroepen. Vaak zijn deze methoden hulpmethoden waar de individuele objecten niets aan hebben. We hebben dit reeds gebruikt bij de `Math` en `Console`-klassen. We behandelen `static` uitgebreid verderop in het boek. ### De tijd uit een string inlezen Parsen laat toe dat je strings omzet naar een `DateTime` object. Dit is handig als je bijvoorbeeld de gebruiker via `Console.ReadLine()` tijd en datum wilt laten invoeren in de *Belgische notatie*: ```csharp string datumInvoer = Console.ReadLine(); DateTime datumVerwerkt = DateTime.Parse(datumInvoer, new System.Globalization.CultureInfo("nl-BE")); Console.WriteLine(datumVerwerkt); ``` Indien je nu dit programma'tje zou uitvoeren en als gebruiker "8/11/2016" zou intypen, dan zal deze datum geparsed worden en in het object `datumVerwerkt` komen. {% hint style="info" %} Zoals je ziet roepen we `Parse` aan op `DateTime` en dus niet op een specifiek object. Dat was ook zo reeds bijvoorbeeld bij `int.Parse` wat dus doet vermoeden dat zelfs het `int` datatype eigenlijk een klasse is! {% endhint %} ### IsLeapYear Deze nuttige methode geeft een `bool` terug om aan te geven of de actuele parameter (type `int`) een schrikkeljaar voorstelt of niet: ```csharp DateTime vandaag = DateTime.Now; if(DateTime.IsLeapYear(vandaag.Year)) Console.WriteLine("Dit jaar is een schrikkeljaar."); ``` ## TimeSpan Je kan DateTime objecten ook van elkaar aftrekken (optellen gaat niet!). Het resultaat van deze bewerking geeft echter niet een DateTime object terug, **maar een `TimeSpan` object**. Dit is nieuwe object van het type `TimeSpan` (wat dus een andere klasse is) dat aangeeft hoe groot het verschil is tussen de 2 DateTime objecten kunnen we als volgt gebruiken: ```csharp DateTime vandaag = DateTime.Today; DateTime geboorteDochter = new DateTime(2009,6,17); TimeSpan verschil = vandaag - geboorteDochter; Console.WriteLine($"{verschil.TotalDays} dagen sinds geboorte dochter."); ``` Je zal de `DateTime` klasse in véél van je projecten kunnen gebruiken waar je iets met tijd, tijdsverschillen of datums wilt doen. We hebben de klasse in deze sectie echter geen eer aangedaan. De klasse is veel krachtiger dan ik hier doe uitschijnen. Het is een goede gewoonte als beginnende programmeur om steeds de documentatie van nieuwe klassen er op na te slaan. > ![](https://2320684026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FouoIA7Dvx8ty0RZ0Hqs1%2Fuploads%2Fgit-blob-66bb631d46cfd2c0792af3cb819969cabb70910b%2Fcare.png?alt=media)Gaat het nog?! Dit was een stevig hoofdstuk he. We hebben zo maar eventjes 4 heel grote fasen doorlopen: > > 1. Eerst keken we hoe OOP ons kan helpen in een real-life voorbeeld, Pong. We schreven code die hier en daar herkenbaar was, maar op andere plaatsen totaal nieuw was. > 2. Vervolgens namen we de mammoet bij de horens en bekeken we de theorie van OO, die ons vooral verwarde. > 3. Gelukkig gingen we dan ogenblikkelijk naar de praktijk over en zagen we dat methoden en properties de kern van iedere klasse blijkt te zijn. > 4. Als afsluiter gooiden we dan de `DateTime` klasse open om een voorproefje te krijgen van hoe krachtig een goedgeschreven klasse kan zijn. > > Voor je verder gaat raad ik je aan om dit alles goed te laten bezinken én maximaal de komende oefeningen te maken. Het zal de beste manier zijn om de ietwat bizarre wereld van OOP snel eigen te maken. [^1]: Technisch gezien is DateTime een `struct`, niet een `class`. Dit onderscheid is in dit handboek niet relevant. Meer informatie over `struct` vind je in de appendix terug. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://apwt.gitbook.io/zie-scherp-scherper/h9-object-oriented-programming/datetime.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.