Data Generation Function List
The data generation functions are categorised logically, making it easier to browse them and find them. They can be used as simple functions, or combined in complex formulae.
Note: for some functions, the cell type must be set. For instance, generating dates requires the cell formatting must be set to the relevant date type. To format cells, right-click the relevant cells and click "format cells", before selecting the relevant formatting. Cell formatting further provides a greater degree of flexibility and increases the variety of data that can be generated using the data generation functions. The formatting can be specified for some functions within the formula itself, as specified below.
Note: The locale is set to the default US English (en_US) in the following examples, unless otherwise stated.
General Functions
Function Name | Description | Example |
---|---|---|
DataGen.FormattedString | Returns a random string, using the format “# = Number, ? = Letter, * = Number or Letter”. | "=DataGen.FormattedString("# = 3, ? = A, * = 5")" Returns: |
DataGen.Random.RandomFromCSV | Returns a random value from a list of specified values. | "=DataGen.Random.RandomFromCSV("Red,Yellow,Green,Blue")" Returns: |
DataGen.SetLocale | Sets the Locale. | "=DataGen.SetLocale("sv")" Returns: |
DataGen.SetSeed | Sets the Seed. | "=DataGen.SetSeed(2)" Returns: |
Numbers
Functions for generating integers and decimals.
Function Name | Description | Example |
---|---|---|
DataGen.Random.RandomDouble | Returns a random double variable less than 1. | "=DataGen.Random.RandomDouble()" Returns: |
DataGen.Random.RandomInt | Returns a random integer value within a defined range. The function is formatted =DataGen.SequenceInt(minValue, maxValue). | "=DataGen.Random.RandomInt(1, 6)" Returns: |
DataGen.Random.RandomLong | Returns a random big integer value within specified long range. The function is formatted =DataGen.Random.RandomLong(minValue, maxValue). | "=DataGen.Random.RandomLong(1,50000)" Returns: |
DataGen.SequenceInt | Returns a random integer from a defined starting point, without duplicate values. The function is formatted =DataGen.SequenceInt(sequence name, starting number). Integers will not duplicate within each given sequence name. | "=DataGen.SequenceInt(1, 1)" Returns: |
Addresses
Functions that generate names and postal addresses.
Function Name | Description | Example |
---|---|---|
DataGen.Address.BuildingNumber | Returns a random building number between 3 and 5 characters for an address. | "=DataGen.Address.BuildingNumber()" Returns: |
DataGen.Address.CityPrefix | Returns a random city prefix. | "=DataGen.Address.CityPrefix()" Returns: |
DataGen.Address.CitySuffix | Returns a random city suffix. | "=DataGen.Address.CitySuffix()" Returns: |
DataGen.Address.Country | Returns a random country. | "=DataGen.Address.Country()" Returns: |
DataGen.Address.CountryCode | Returns a random country code. | "=DataGen.Address.CountryCode()" Returns: |
DataGen.Address.County | Returns a random English county. | "=DataGen.Address.County()" Returns: |
DataGen.Address.FullAddress | Returns a random full address. | "=DataGen.Address.FullAddress()" Returns: 71186 Eichmann Gateway, North |
DataGen.Address.Latitude | Returns a random latitude. | "=DataGen.Address.Latitude()" Returns: |
DataGen.Address.Longitude | Returns a random longitude. | "=DataGen.Address.Longitude()" Returns: |
DataGen.Address.SecondaryAddress | Returns a random secondary address. | "=DataGen.Address.SecondaryAddress()" Returns: |
DataGen.Address.State | Returns a random state. | "=DataGen.Address.State()" Returns: When Locale is set to en_IND. |
DataGen.Address.StateAbbr | Returns a random state abbreviation. | "=DataGen.Address.StateAbbr()" Returns: When Locale is set to en_US. |
DataGen.Address.StreetAddress | Returns a random street address. | "=DataGen.Address.StreetAddress()" Returns: When Locale is set to SV. |
DataGen.Address.StreetName | Returns a random street name. | "=DataGen.Address.StreetName()" Returns: When Locale is set to fr. |
DataGen.Address.StreetSuffix | Returns a random street suffix. | "=DataGen.Address.StreetSuffix()" Returns: When Locale is set to nl. |
DataGen.Address.ZipCode | Returns a random zip code. | "=DataGen.Address.ZipCode()" Returns: When Locale is set to en_GB |
Product and company
Functions that generate company and product information.
Function Name | Description | Example |
---|---|---|
DataGen.Commerce.Category | Returns a random product category. | "=DataGen.Commerce.Category" Returns: |
DataGen.Commerce.Color | Returns a random color. | "=DataGen.Commerce.Color" Returns: |
DataGen.Commerce.Price | Returns a random product price. The function is formatted =DatGen.Commerce.Price(minimum value, maximum value, number of decimal places, currency symbol). Note: the cell must be formatted to the relevant currency for the symbols to be generated. | "=DataGen.Commerce.Price(1,4,2,"$")" Returns: When the cell is formatted to currency, with the symbol “$” set. |
DataGen.Commerce.Product | Returns a random product. | "=DataGen.Commerce.Product()" Returns: |
DataGen.Commerce.ProductAdjective | Returns a random product adjective. | "=DataGen.Commerce.ProductAdjective" Returns: |
DataGen.Commerce.ProductMaterial | Returns a random product material. | "=DataGen.Commerce.ProductMaterial" Returns: |
DataGen.Commerce.ProductName | Returns a random, three word product name, combining adjective, material, product type. | "=DataGen.Commerce.ProductName()" Returns: |
DataGen.Company.Bs | Returns a random piece of company jargon or management speak. | "=DataGen.Company.Bs()" Returns: |
DataGen.Company.CatchPhrase | Returns a random company catch phrase. | "=DataGen.Company.CatchPhrase()" Returns: |
DataGen.Company.CompanyName | Returns a random company name. | "=DataGen.Company.CompanyName()" Returns: When Locale is set to en_GB |
DataGen.Company.CompanySuffix | Returns a random company suffix. | "=DataGen.Company.CompanySuffix()" Returns: |
Database
Functions that generate metadata describing a database.
Function Name | Description | Example |
---|---|---|
DataGen.Database.Collation | Returns a random database collation. | "= DataGen.Database.Collation()" Returns: |
DataGen.Database.Column | Returns a random database column name. | "=DataGen.Database.Column()" Returns: |
DataGen.Database.Engine | Returns a random database storage engine. | "=DataGen.Database.Engine()" Returns: |
DataGen.Database.Type | Returns a random database column type. | "=DataGen.Database.Type()" Returns: |
Dates
Functions that generate dates.
Function Name | Description | Example |
---|---|---|
DataGen.Date.Future | Returns a random date in the future, with the number of future years specified in the format =DataGen.Date.Future(number of years to go forward) . Note: the cell must be formatted to date, with the correct format. | "=DataGen.Date.Future(4)" Returns: When the cell formatting is set to number/date/*3/14/2012 and the locale is set to English (US). |
DataGen.Date.Month | Returns a random month. | "=DataGen.Date.Month()" Returns: |
DataGen.Date.MonthAbbr | Returns a random month abbreviation. | "=DataGen.Date.MonthAbbr" Returns: |
DataGen.Date.Past | Returns a random date in the past, with the number of past years specified in the format =DataGen.Date.Past(number of years to go back). Note: the cell must be formatted to date, with the correct format. | "=DataGen.Date.Past(80)" Returns: When the cell formatting is set to number/date/*3/14/2012 and the locale is set to English (US). |
DataGen.Date.Recent | Returns a random date within a number of days of the current date, specified in the format =DataGen.Date.Recent(number of days). The number of days is set to 30 by default. Note: the cell must be formatted to date, with the correct format. | "=DataGen.Date.Recent(5)" Returns: When the function is executed on 10/09/2018 and the cell formatting is set to number/date/*3/14/2012 and the locale is set to English (US). |
DataGen.Date.Weekday | Returns a random weekday | "=DataGen.Date.Weekday()" Returns: |
DataGen.Date.WeekdayAbbr | Returns a random weekday abbreviation | "=DataGen.Date.WeekdayAbbr()" Returns: |
DataGen.Random.RandomDate | Returns a random date within a specified range. The function is formatted =DataGen.SequenceInt(“day, month, year”, “day, month, year”). Note: the cell must be formatted to date, with the correct format. | "=DataGen.Random.RandomDate("1/1/1900", "7/19/2018")" Returns: When the cell formatting is set to number/date/*3/14/2012 and the locale is set to English (US). |
Finance
Functions that generate account, currency, and transaction information.
Function Name | Description | Example |
---|---|---|
DataGen.Finance.Account | Returns a random account number. | "=DataGen.Finance.Account()" Returns: |
DataGen.Finance.AccountName | Returns a random account name like Savings, Checkings, Home Loan etc. | "=DataGen.Finance.AccountName()" Returns: |
DataGen.Finance.AccountOfSpecifiedLength | Returns a random account number of a length specified in the format =DataGen.Finance.AccountOfSpecifiedLength(number of digits). The number of digits is set to 8 by default. | "=DataGen.Finance.AccountOfSpecifiedLength(12)" Returns 12 Digit Account Numbers: |
DataGen.Finance.Amount | Returns a random amount within a specified range. | "=DataGen.Finance.Amount()" Returns: |
DataGen.Finance.AmountWithDetails | Returns a random amount within a range specified in the fromat =DataGen.Finance>AmountWithDetails(minimum amount, maximum amount, number of decimal places). | "=DataGen.Finance.AmountWithDetails(1, 1000,2)" Returns a random amount between 1 and 1000, and two decimal places: |
DataGen.Finance.Bic | Returns a random bank identifier code (Bic). | "=DataGen.Finance.Bic()" Returns: |
DataGen.Finance.BitcoinAddress | Returns a random bitcoin address. | "=DataGen.Finance.BitcoinAddress()" Returns: |
DataGen.Finance.CreditCardNumber | Returns a random valid credit card number. | "=DataGen.Finance.CreditCardNumber()" Returns: |
DataGen.Finance.Currency.Code | Returns a random currency code. | "=DataGen.Finance.Currency.Code()" Returns: |
DataGen.Finance.Currency.Description | Returns a random currency description. | "=DataGen.Finance.Currency.Description()" Returns: |
DataGen.Finance.Currency.Symbol | Returns a random currency symbol. | "=DataGen.Finance.Currency.Symbol()" Returns: |
DataGen.Finance.TransactionType | Returns a random transaction type: Deposit, Withdrawl, Payment or Invoice. | "=DataGen.Finance.TransactionType()" Returns: |
Name
Functions that generate names, prefixes, and job descriptors.
Function Name | Description | Example |
---|---|---|
Data Generation Functions - Names | Returns a first name. | "=DataGen.Name.FirstName" Returns: When Locale is set to ja |
DataGen.Name.FullName | Returns a full name. | "=DataGen.Name.FullName()" Returns: When Locale is set to sv |
DataGen.Name.JobArea | Returns a job specialism. | "=DataGen.Name.JobArea()" Returns: |
DataGen.Name.JobDescriptor | Returns a job descriptor. | "=DataGen.Name.JobDescriptor()" Returns: |
DataGen.Name.JobTitle | Returns a job title. | "=DataGen.Name.JobTitle()" Returns: |
DataGen.Name.JobType | Returns a job type. | "=DataGen.Name.JobType()" Returns: |
DataGen.Name.LastName | Returns a last name. | "=DataGen.Name.LastName()" Returns: When Locale is set to it |
DataGen.Name.Prefix | Returns a name prefix. | "=DataGen.Name.Prefix()" Returns: When Locale is set to el |
DataGen.Name.Suffix | Returns a name suffix. | "=DataGen.Name.Suffix()" Returns: |
Phone
Functions that generate phone numbers in specific formats.
Function Name | Description | Example |
---|---|---|
DataGen.Phone.PhoneNumber | Returns a random phone number, specified by the locale. | "=DataGen.Phone.PhoneNumber()" Returns: +910245048269 When Locale is set to en_IND |
DataGen.Phone.PhoneNumberWithFormat | Returns a random phone number, specified by the locale. Formats are specified within bracket and double quotation marks. Hash signs (#) will be replaced with a random number, and all other characters such as spaces, dashes, and bracket, will be replicated literally. |
Internet
Functions that generate information relating to email, IP, URL, and online account details.
Function Name | Description | Example |
---|---|---|
DataGen.Internet.Avatar | Returns an online avatar. | "=DataGen.Internet.Avatar()" Returns: |
DataGen.Internet.DomainName | Returns an internet domain name. | "=DataGen.Internet.DomainName()" Returns: |
DataGen.Internet.DomainSuffix | Returns a domain name suffix e.g. .com, .net, .org | "=DataGen.Internet.DomainSuffix()" Returns: |
DataGen.Internet.DomainWord | Returns a random word used in domain names. | "=DataGen.Internet.DomainWord()" Returns: |
DataGen.Internet.Email | Returns an email address. | "=DataGen.Internet.Email()" Returns: |
DataGen.Internet.EmailWithDetails | Returns variations of an email using a first name, last name, and provider, specified in the format =DataGen.Internet.EmailWithDetails(“firstname, lastname, provider”). | "=DataGen.Internet.EmailWithDetails("firstname", "lastname", "provider.com")" Returns: |
DataGen.Internet.Ip | Returns an IP address. | "=DataGen.Internet.Ip()" Returns: |
DataGen.Internet.Ipv6 | Returns an IP V6 address. | "=DataGen.Internet.Ipv6()" Returns: |
DataGen.Internet.Mac | Returns a Mac address. | "=DataGen.Internet.Mac()" Returns: |
DataGen.Internet.Password | Returns a password. | "=DataGen.Internet.Password()" Returns: |
DataGen.Internet.PasswordWithDetails | Returns a password of a length specified in the format =DataGen.Internet.PassWithDetails(number of characters). | "=DataGen.Internet.PasswordWithDetails(6)" Returns: |
DataGen.Internet.Protocol | Returns a protocol http or https. | "=DataGen.Internet.Protocol()" Returns: |
DataGen.Internet.Url | Returns a URL. | "=DataGen.Internet.Url()" Returns: |
DataGen.Internet.UserAgent | Returns a UserAgent. Data generated by this function reflects the prevalence of Mozilla over Opera. | "=DataGen.Internet.UserAgent()" Returns: |
DataGen.Internet.UserName | Returns a username. | "=DataGen.Internet.UserName()" Returns: |
DataGen.Internet.WithDetails | Returns a username using variations of a first and last name, specified in the format =DataGen.Internet.WithDetails(“firstname”, “lastname”). | "=DataGen.Internet.WithDetails(“first”, “last”)" Returns: |
"Hacker"
Functions that generate basic linguistics units loosely associated with hackers.
Function Name | Description | Example |
---|---|---|
DataGen.Hacker.Abbreviation | Returns an abbreviation for a random word. | "=DataGen.Hacker.Abbreviation()" Returns: |
DataGen.Hacker.Adjective | Returns a random word which, in this case, is an adjective. | "=DataGen.Hacker.Adjective()" Returns: |
DataGen.Hacker.IngVerb | Returns a random '-ing' verb, a present participle. | "=DataGen.Hacker.IngVerb()" Returns: |
DataGen.Hacker.Noun | Returns a random word which, in this case, is a noun. | "=DataGen.Hacker.Noun()" Returns: |
DataGen.Hacker.Phrase | Returns a phrase. | "=DataGen.Hacker.Phrase()" Returns: |
DataGen.Hacker.Verb | Returns a random word which, in this case, is a verb. | "=DataGen.Hacker.Verb()" Returns: |
Text
Functions that generate placeholder text.
Function Name | Description | Example |
---|---|---|
DataGen.Lorem.Lines | Returns lines of lorem ipsum filler text. | "=DataGen.Lorem.Lines()" Returns: |
DataGen.Lorem.Paragraph | Returns one paragraph of lorem ipsum filler text. | "=DataGen.Lorem.Paragraph()" Returns: |
DataGen.Lorem.Paragraphs | Returns a number of paragraphs of lorem ipsum filler text., specified in the format =DataGen.Lorem.Paragraphs(number of paragraphs) | "=DataGen.Lorem.Paragraphs(2)" Returns: |
DataGen.Lorem.Review | Returns a user review in English. | "=DataGen.Lorem.Review()" Returns: |
DataGen.Lorem.Sentence | Returns a sentence of lorem ipsum filler text. | "=DataGen.Lorem.Sentence()" Returns: |
DataGen.Lorem.Sentences | Returns a number of sentences of lorem ipsum filler text., specified in the format =DataGen.Lorem.Paragraphs(number of sentences) | "=DataGen.Lorem.Sentences(2)" Returns: |
DataGen.Lorem.Slug | Returns a lorem ipsum slug of length specified in the format =Datagen.Lorem.Slug(numer of words) | "=DatGen.Lorem.Slug(4)" Returns: |
DataGen.Lorem.Text | Returns text using one of the other Lorem functions. | "=DataGen.Lorem.Text()" Returns: |
DataGen.Lorem.Word | Returns a ipsum word | "=DataGen.Lorem.Word()" Returns: |
DataGen.Lorem.Words | Returns a number of ipsum lorem words | "=DataGen.Lorem.Words()" Returns: |
String Extensions
Functions that process a string.
Function Name | Description | Example |
---|---|---|
DataGen.General.Random.Parse | Returns a string value after resolving a set of functions specified in the format =DataGen.Random.Parse(“{{function1}} {{function2}} {{functionN}}”). | "=DataGen.Random.Parse("{{name.prefix}} {{name.lastname}} {{name.suffix}}")" Returns: |
DataGen.Random.RandomStringFixedLength | Returns a random string of fixed length with or without numbers and special characters. The function is formatted =DataGen.Random.RandomStringFixedLength(length, includeNumbers, includeSpecialChars) | "=DataGen.Random.RandomStringFixedLength(7,TRUE,TRUE)" Returns: |
DataGen.General.Random.Spin | Returns a random string value after ‘spinning’ text. Spinning generates variations of variables specified in the format =DataGen.Random.Spin(“{{variable 1|variable2|variable}}”). Spin functions can be strung together. Values outside of squiggly brackets will be reproduced literally. | "=DataGen.Random.Spin("{{Red|Yellow} is {my|your} {favourite|least favourite} colour }")" Returns |