DEV Community

Peter + AI
Peter + AI

Posted on

Let's Talk About Dates in Uniface! πŸ“…

Hey everyone! πŸ‘‹

If you're working with the low-code platform Uniface, you know that handling data correctly is super important. Today, we're going to look at one of the most basic building blocks: the date data type in Uniface 10.4.

Full disclosure: This post was created with the help of an AI to explain the official documentation in simple terms.

What Exactly is the date Data Type? πŸ€”

In Uniface, the date data type isn't just any date. It's a special data type that stores a date as a sequence of numbers in a very specific format: ccyymmdd.

  • cc: Century
  • yy: Year
  • mm: Month
  • dd: Day

So, for example, Christmas Day 2025 would be stored as the number 20251225. It's a simple, number-based representation without any dashes or slashes.

Show Me the Code! πŸ’»

You'll most often use the date type when you define variables or parameters in your ProcScript code. The documentation mentions you can use it in params and variables blocks.

Here’s a simple example of how to declare a date variable in a component's script:


variables
  date vMyDeadline
endvariables

vMyDeadline = 20260131  ; This sets the deadline to January 31, 2026
message "The project deadline is: %%vMyDeadline"
Enter fullscreen mode Exit fullscreen mode

In this snippet, we created a variable named vMyDeadline and gave it the type date. Then, we assigned a value to it using the ccyymmdd format.

Working with Other Data? Use $date! ✨

What if your date is in a different format, like a string from a user input? That's where the built-in $date function comes in handy. You can use it to convert other data types into the proper Uniface date format.

Let's say you have a string. You can convert it like this:


variables
  string vDateString
  date vConvertedDate
endvariables

vDateString = "2025-11-15" ; A common string format
vConvertedDate = $date(vDateString) ; Convert the string to a Uniface date

; Now, vConvertedDate holds the value 20251115
message "The converted date is: %%vConvertedDate"
Enter fullscreen mode Exit fullscreen mode

The $date function is smart enough to understand many common date formats and convert them for you. This is essential for making your application robust.

Key Takeaways πŸš€

  • The Uniface date data type stores dates in the numeric ccyymmdd format.
  • You declare date variables in the variables block of your ProcScript.
  • Use the $date function to convert strings or other data types into a proper Uniface date.

And that's a quick intro to the date data type! It’s a fundamental concept, but getting it right is key to building solid Uniface applications. Happy coding!

Top comments (0)