Replace і Substitute функції

Застосовується до: Canvas apps Copilot Studio Desktop flows Dataverse formula columns Model-driven apps Power Platform CLI Dataverse functions Power Pages

Replace частина рядка тексту з іншим рядком.

Опис

Функція Replace визначає текст для заміни початковим розташуванням і довжиною.

Функція Substitute визначає текст, який потрібно замінити, зіставляючи рядок. Якщо знайдено більше однієї відповідності, можна замінити їх усі або вказати для заміни одну з них.

Якщо передати один рядок, то повернуте значення буде зміненим рядком. Якщо передати таблицю з одним стовпцем , яка містить рядки, поверненим значенням буде таблиця з одним стовпцем зі стовпцем «Значення » змінених рядків. Якщо ваша таблиця має кілька стовпців, ви можете переробити її на таблицю з одним стовпцем, як описано в розділі Робота з таблицями.

Синтаксис

Replace( Рядок, початковапозиція, numberOfCharacters, NewString )

• Рядок - обов’язковий. Рядок для роботи.
• Стартова позиція - обов’язкова. Розташування символу, з якого потрібно почати заміну. Перший символ рядка має розташування 1.
• NumberOfCharacters- обов’язковий . Кількість символів, які потрібно замінити в рядку.
• NewString - обов’язковий. Рядок на заміну. Кількість символів у цьому аргументі може відрізнятись від аргументу NumberOfCharacters.

Substitute( Рядок, OldString, NewString [, InstanceNumber ] )

• Рядок - обов’язковий. Рядок для роботи.
• OldString - обов’язковий. Рядок, який потрібно замінити.
• NewString - обов’язковий. Рядок на заміну. OldString і NewString можуть мати різну довжину.
• InstanceNumber - необов’язковий. Використовуйте цей аргумент, щоб указати, який екземпляр OldString потрібно замінити, якщо рядок містить більше одного екземпляра. Якщо цей аргумент не вказано, буде замінено всі екземпляри.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - обов’язковий. Таблиця з одним стовпцем, що містить рядки, для яких потрібно виконати операцію.
• Стартова позиція - обов’язкова. Розташування символу, з якого потрібно почати заміну. Перший символ кожного рядка в таблиці має розташування 1.
• NumberOfCharacters- обов’язковий . Кількість символів, які потрібно замінити в кожному рядку.
• NewString - обов’язковий. Рядок на заміну. Кількість символів у цьому аргументі може відрізнятись від аргументу NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - обов’язковий. Таблиця з одним стовпцем, що містить рядки, для яких потрібно виконати операцію.
• OldString - обов’язковий. Рядок, який потрібно замінити.
• NewString - обов’язковий. Рядок на заміну. OldString і NewString можуть мати різну довжину.
• InstanceNumber - необов’язковий. Використовуйте цей аргумент, щоб указати, який екземпляр OldString потрібно замінити, якщо рядок містить більше одного екземпляра. Якщо цей аргумент не вказано, буде замінено всі екземпляри.

Приклади

Формула	Опис	Результат
Replace( "abcdefghijk", 6, 5, "*" )	Замінює п’ять символів у «abcdefghijk» на один символ «*», починаючи з шостого символу («f»).	«abcde*k»
Replace( "2019", 3, 2, "20" )	Замінює останні два символи «2019» на «20».	«2020»
Replace( "123456", 1, 3, "_" )	Замінює перші три символи «123456» на один символ «_».	«_456»
Substitute( "Дані збуту", "Збут", "Вартість" )	Заміняє рядок «Вартість» на «Збут».	«Відомості про вартість»
Substitute( "Квартал 1, 2018", "1", "2", 1 )	Замінює лише перший екземпляр «1» на «2», оскільки четвертий аргумент (InstanceNumber) має значення «1».	«Квартал 2, 2018»
Substitute( "Квартал 1, 2011", "1", "2", 3 )	Замінює лише третій екземпляр «1» на «2», оскільки четвертий аргумент (InstanceNumber) має значення «3».	«Квартал 1, 2012»
Substitute( "Квартал 1, 2011", "1", "2" )	Замінює всі екземпляри «1» на «2», оскільки четвертого аргументу (InstanceNumber) немає.	«Квартал 2, 2022»
Replace( [ "Квартал 1, 2018", "2 квартал 2011 року", "4 квартал 2019 р." ], 9, 1, "3" )	Замінює дев’ятий символ у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "3 квартал 2018 року", «Квартал3,2011», "Квартал 3, 2019" ]
Substitute( [ "Кв. 1, 2018", "Квартал 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Оскільки четвертий аргумент (InstanceNumber) надається зі значенням «1», він замінює лише перший екземпляр «1» у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "Qtr 3, 2018", «Квартал3,2011», «Кв. 3,2019»]
Substitute( [ "Кв. 1, 2018", "Квартал 1, 2011", "Q1, 2019" ], "1", "3" )	Оскільки четвертий аргумент (InstanceNumber) не надається, він замінює всі екземпляри «1» у кожному записі таблиці з одним стовпцем зі значенням «3».	Таблиця з одним стовпцем зі Value стовпцем, що містить такі значення: [ "Qtr 3, 2038", "Квартал 3, 2033", «Кв. 3,2039»]